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/23b1dac9-9ba6-473a-bcf4-94b0a21ea1b9/?format=api
{ "id": "23b1dac9-9ba6-473a-bcf4-94b0a21ea1b9", "url": "https://ll.thespacedevs.com/2.2.0/launch/23b1dac9-9ba6-473a-bcf4-94b0a21ea1b9/?format=api", "slug": "atlas-v-401-nrol-24-usa-198", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas V 401 | NROL-24 (USA-198)", "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-06-14T17:42:40Z", "updates": [], "net": "2007-12-10T22:05:00Z", "net_precision": null, "window_end": "2007-12-10T22:05:00Z", "window_start": "2007-12-10T22:05:00Z", "probability": 0, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": "", "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": 168, "consecutive_successful_launches": 168, "successful_launches": 168, "failed_launches": 0, "pending_launches": 43, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.ulalaunch.com/", "wiki_url": "https://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": 1386, "configuration": { "id": 16, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/16/?format=api", "name": "Atlas V 401", "active": true, "reusable": false, "description": "An Atlas V with a 4 meter diameter fairing, no boosters and a single centaur upper stage engine.", "family": "Atlas", "full_name": "Atlas V 401", "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": 168, "consecutive_successful_launches": 168, "successful_launches": 168, "failed_launches": 0, "pending_launches": 43, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.ulalaunch.com/", "wiki_url": "https://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": "401", "alias": "", "min_stage": 2, "max_stage": 2, "length": 58.3, "diameter": 3.8, "maiden_flight": "2002-08-21", "launch_cost": "115000000", "launch_mass": 590, "leo_capacity": 9050, "gto_capacity": 4950, "to_thrust": 3827, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas_v_image_20201212013334.jpeg", "info_url": "https://www.ulalaunch.com/rockets/atlas-v", "wiki_url": "https://en.wikipedia.org/wiki/Atlas_V", "total_launch_count": 41, "consecutive_successful_launches": 41, "successful_launches": 41, "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": 544, "name": "NROL-24 (USA-198)", "description": "A military reconnaissance satellite, it's purpose is classified.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 0, "name": "Elliptical Orbit", "abbrev": "Elliptical" }, "agencies": [], "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": 1058, "total_landing_count": 68 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg", "total_launch_count": 118, "orbital_launch_attempt_count": 118 }, "infoURLs": [ { "priority": 0, "source": null, "title": "Satellite Data System - Wikipedia", "description": "The Satellite Data System (SDS) is a system of United States military communications satellites. At least three generations have been used: SDS-1 from 1976 to 1987; SDS-2 from 1989 to 1996; SDS-3 from 1998 to the present. It is believed that these satellites were known by the code name Quasar.[1] Th...", "feature_image": null, "url": "https://en.wikipedia.org/wiki/Satellite_Data_System", "type": null, "language": null } ], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas_v_image_20201212013334.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 4880, "location_launch_attempt_count": 653, "pad_launch_attempt_count": 39, "agency_launch_attempt_count": 14, "orbital_launch_attempt_count_year": 63, "location_launch_attempt_count_year": 9, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 12, "pad_turnaround": "P60DT21H43M", "mission_patches": [ { "id": 473, "name": "NROL-24 (USA-198) Patch", "priority": 9, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/nrol-24252025_mission_patch_20211031044054.png", "agency": { "id": 181, "url": "https://ll.thespacedevs.com/2.2.0/agencies/181/?format=api", "name": "National Reconnaissance Office", "type": "Government" } } ], "type": "detailed" }
