Launch Instance
AN API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/[id]/ or /launch/?mode=list&search=SpaceX
GET Return a list of all Launch objects.
FILTERS Fields - 'name', 'id(s)', 'lsp__id', 'lsp__name', 'serial_number', 'launcher_config__id', 'rocket__spacecraftflight__spacecraft__name', 'is_crewed', 'include_suborbital', 'spacecraft_config__ids', 'related', 'location__ids', 'lsp__ids', 'pad__ids', 'status__ids'
MODE 'normal', 'list', 'detailed'
EXAMPLE ?mode=list
SEARCH Searches through the launch name, rocket name, launch agency, mission name & spacecraft name.
EXAMPLE - ?search=SpaceX
GET /2.2.0/launch/df8d4fdb-9add-4ce9-9f0e-aae1c61df212/?format=api
{ "id": "df8d4fdb-9add-4ce9-9f0e-aae1c61df212", "url": "https://ll.thespacedevs.com/2.2.0/launch/df8d4fdb-9add-4ce9-9f0e-aae1c61df212/?format=api", "slug": "atlas-v-541-msl-curiosity", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas V 541 | MSL (Curiosity)", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-11-11T12:52:59Z", "updates": [], "net": "2011-11-26T15:02:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2011-11-26T15:02:00Z", "window_start": "2011-11-26T15:02:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "rocket": { "id": 1569, "configuration": { "id": 1, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/1/?format=api", "name": "Atlas V 541", "active": true, "reusable": false, "description": "Atlas V with 5m Fairing, 4 SRB, 1 Centaur upper stage engine.", "family": "Atlas", "full_name": "Atlas V 541", "manufacturer": { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "program": [], "variant": "541", "alias": "", "min_stage": 0, "max_stage": 2, "length": 60.0, "diameter": 3.8, "maiden_flight": "2011-11-26", "launch_cost": "145000000", "launch_mass": 479, "leo_capacity": 17410, "gto_capacity": 8290, "to_thrust": null, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520541_image_20190224012314.jpeg", "info_url": "https://www.ulalaunch.com/rockets/atlas-v", "wiki_url": null, "total_launch_count": 9, "consecutive_successful_launches": 9, "successful_launches": 9, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6649, "name": "MSL (Curiosity)", "description": "The Mars Science Laboratory (MSL) mission, featuring the renowned Curiosity rover, was designed to assess the planet's past and present habitability. Equipped with an array of advanced scientific instruments, including a drill and a sample analysis unit, Curiosity explored the Gale Crater, a site believed to contain evidence of ancient Martian environments. It delivered groundbreaking discoveries, including the detection of organic molecules and the confirmation of an ancient, potentially habitable lake bed.", "launch_designator": null, "type": "Robotic Exploration", "orbit": { "id": 19, "name": "Mars Orbit", "abbrev": "Mars" }, "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "featured": true, "type": "Government", "country_code": "USA", "abbrev": "NASA", "description": "The National Aeronautics and Space Administration is an independent agency of the executive branch of the United States federal government responsible for the civilian space program, as well as aeronautics and aerospace research. NASA have many launch facilities but most are inactive. The most commonly used pad will be LC-39B at Kennedy Space Center in Florida.", "administrator": "Acting Administrator: James Free", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 141, "consecutive_successful_launches": 11, "successful_launches": 121, "failed_launches": 20, "pending_launches": 6, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.nasa.gov", "wiki_url": "http://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/pad/29/?format=api", "agency_id": null, "name": "Space Launch Complex 41", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_41", "map_url": "https://www.google.com/maps?q=28.58341025,-80.58303644", "latitude": "28.58341025", "longitude": "-80.58303644", "location": { "id": 12, "url": "https://ll.thespacedevs.com/2.2.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 1024, "total_landing_count": 64 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg", "total_launch_count": 115, "orbital_launch_attempt_count": 115 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Mars Science Laboratory Lifts Off for Red Planet", "description": "NASA's Curiosity rover has begun the journey to Mars after its Atlas V rocket launched successfully from the Cape Canaveral Air Force Station on Nov. 26. Ten...", "feature_image": "https://i.ytimg.com/vi/jEXoMpmfJcM/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=jEXoMpmfJcM", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas2520v2520541_image_20190224012314.jpeg", "infographic": null, "program": [ { "id": 36, "url": "https://ll.thespacedevs.com/2.2.0/program/36/?format=api", "name": "NASA Large Strategic Science Missions", "description": "NASA's large strategic science missions or large strategic missions, formerly known as Flagship missions or Flagship-class missions, are the costliest and most capable NASA science spacecraft. Flagship missions exist within all four divisions of NASA's Science Mission Directorate (SMD): the astrophysics, Earth science, heliophysics and planetary science divisions.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/nasa2520large_program_20240205122003.jpeg", "start_date": "1975-08-22T00:00:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Large_strategic_science_missions", "mission_patches": [], "type": { "id": 5, "name": "Exploration" } } ], "orbital_launch_attempt_count": 5179, "location_launch_attempt_count": 683, "pad_launch_attempt_count": 51, "agency_launch_attempt_count": 57, "orbital_launch_attempt_count_year": 73, "location_launch_attempt_count_year": 7, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 11, "pad_turnaround": "P112DT22H37M", "mission_patches": [], "type": "detailed" }
