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/793c9a86-b242-417c-893a-790222a28fc7/?format=api
{ "id": "793c9a86-b242-417c-893a-790222a28fc7", "url": "https://ll.thespacedevs.com/2.2.0/launch/793c9a86-b242-417c-893a-790222a28fc7/?format=api", "slug": "vega-c-sbg-tir", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vega-C | SBG-TIR", "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2025-02-13T10:44:01Z", "updates": [ { "id": 10096, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch NET 2029", "info_url": "https://4aspace.fr/l-actualite-des-satellites/thales-alenia-space-contribuera-a-la-mission-dobservation-de-la-terre-surface-biology-geology-sbg-de-la-nasa/", "created_by": "Nosu", "created_on": "2025-02-13T10:44:00Z" } ], "net": "2029-12-31T00:00:00Z", "net_precision": { "id": 14, "name": "Year", "abbrev": "Y", "description": "The T-0 is expected in the given year." }, "window_end": "2029-12-31T00:00:00Z", "window_start": "2029-12-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 159, "url": "https://ll.thespacedevs.com/2.2.0/agencies/159/?format=api", "name": "Avio S.p.A", "featured": true, "type": "Commercial", "country_code": "ITA", "abbrev": "Avio", "description": "Avio S.p.A. is an Italian company operating in the aerospace sector with its head office in Colleferro near Rome, Italy. Founded in 1908, it is present in Italy and abroad with different commercial offices and 10 production sites.", "administrator": "CEO: Giulio Ranzo", "founding_year": "1908", "launchers": "Vega", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 3, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.avio.com/", "wiki_url": "http://en.wikipedia.org/wiki/Avio", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio2520s.p.a_logo_20221130103121.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio_social_log_image_20250211190007.jpg" }, "rocket": { "id": 8525, "configuration": { "id": 127, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/127/?format=api", "name": "Vega-C", "active": true, "reusable": false, "description": "Vega-C is a single-body rocket nearly 35 m high with that weighs 210 tonnes on the launch pad. As with Vega, its main elements are three solid-propellant stages, an upper stage powered by a reignitable liquid-propellant engine and a payload fairing. Vega-C's P120C first stage replaces Vega’s smaller P80 to provide a significant increase in thrust at liftoff. It is also used as boosters (2 or 4) for the Ariane 6 rocket.", "family": "Vega", "full_name": "Vega-C", "manufacturer": { "id": 159, "url": "https://ll.thespacedevs.com/2.2.0/agencies/159/?format=api", "name": "Avio S.p.A", "featured": true, "type": "Commercial", "country_code": "ITA", "abbrev": "Avio", "description": "Avio S.p.A. is an Italian company operating in the aerospace sector with its head office in Colleferro near Rome, Italy. Founded in 1908, it is present in Italy and abroad with different commercial offices and 10 production sites.", "administrator": "CEO: Giulio Ranzo", "founding_year": "1908", "launchers": "Vega", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 3, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.avio.com/", "wiki_url": "http://en.wikipedia.org/wiki/Avio", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio2520s.p.a_logo_20221130103121.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio_social_log_image_20250211190007.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 4, "max_stage": 4, "length": 35.0, "diameter": 3.0, "maiden_flight": "2022-07-13", "launch_cost": "48000000", "launch_mass": 210, "leo_capacity": 3300, "gto_capacity": null, "to_thrust": 2974, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "info_url": "http://www.arianespace.com/vehicle/vega/", "wiki_url": "https://en.wikipedia.org/wiki/Vega_(rocket)", "total_launch_count": 4, "consecutive_successful_launches": 2, "successful_launches": 3, "failed_launches": 1, "pending_launches": 23, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7115, "name": "SBG-TIR", "description": "The Surface Biology and Geology - Thermal Infrared (SBG-TIR) Earth Observation mission aims to provide radiometric and multispectral measurements of terrestrial and aquatic emissions for climate, ecological, and geological analyses, and to support practical applications such as food security and water management. The thermal infrared (TIR) radiometer is provided by NASA, while the VIS-NIR camera is provided by ASI. Their combination ensures high-quality observations, enabling the investigation of terrestrial and marine ecosystems, monitoring of water resources, and phenomena related to high temperatures such as wildfires and volcanic eruptions.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [ { "id": 36, "url": "https://ll.thespacedevs.com/2.2.0/agencies/36/?format=api", "name": "Italian Space Agency", "featured": false, "type": "Government", "country_code": "ITA", "abbrev": "ASI", "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 3, "consecutive_successful_launches": 3, "successful_launches": 3, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.asi.it/", "wiki_url": "http://en.wikipedia.org/wiki/Italian_Space_Agency", "logo_url": null, "image_url": null, "nation_url": null }, { "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": 34, "url": "https://ll.thespacedevs.com/2.2.0/pad/34/?format=api", "agency_id": 115, "name": "Ariane Launch Area 1 (ELV)", "description": "ELA-1, now named Ensemble de Lancement Vega (short ELV), is a launch pad at the Centre Spatial Guyanais in French Guiana. It has been used to support launches of the Europa rocket, Ariane 1, Ariane 3, and is currently used to launch Vega rockets.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/ELA-1", "map_url": "https://www.google.com/maps?q=5.236,-52.775", "latitude": "5.236", "longitude": "-52.775", "location": { "id": 13, "url": "https://ll.thespacedevs.com/2.2.0/location/13/?format=api", "name": "Guiana Space Centre, French Guiana", "country_code": "GUF", "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "timezone_name": "America/Cayenne", "total_launch_count": 325, "total_landing_count": 0 }, "country_code": "GUF", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_34_20200803143527.jpg", "total_launch_count": 52, "orbital_launch_attempt_count": 52 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7266, "location_launch_attempt_count": 366, "pad_launch_attempt_count": 74, "agency_launch_attempt_count": 3, "orbital_launch_attempt_count_year": 16, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P396D", "mission_patches": [], "type": "detailed" }
