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/a2a87bed-7e8c-4680-a282-045c4ffe9917/?format=api
{ "id": "a2a87bed-7e8c-4680-a282-045c4ffe9917", "url": "https://ll.thespacedevs.com/2.2.0/launch/a2a87bed-7e8c-4680-a282-045c4ffe9917/?format=api", "slug": "vega-c-co3d-microcarb", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vega-C | CO3D & MicroCarb", "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-04-05T00:31:47Z", "updates": [ { "id": 10627, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET July.", "info_url": "https://aeromorning.com/en/the-microcarb-satellite-a-new-european-tool-for-studying-the-climate/", "created_by": "Cosmic_Penguin", "created_on": "2025-04-05T00:31:00Z" }, { "id": 10041, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding MicroCarb as secondary payload with CO3D", "info_url": "https://cnes.fr/actualites/spatial-francais-10-dates-de-2025-ne-manquer", "created_by": "Nosu", "created_on": "2025-02-07T21:44:00Z" }, { "id": 9437, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET June.", "info_url": "https://cnes.fr/en/projects/co3d", "created_by": "Cosmic_Penguin", "created_on": "2024-12-06T08:34:00Z" }, { "id": 9350, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch", "info_url": "https://cnes.fr/en/projects/co3d", "created_by": "Nosu", "created_on": "2024-11-27T09:52:00Z" } ], "net": "2025-07-31T00:00:00Z", "net_precision": { "id": 7, "name": "Month", "abbrev": "M", "description": "The T-0 is expected in the given month." }, "window_end": "2025-07-31T00:00:00Z", "window_start": "2025-07-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "featured": true, "type": "Commercial", "country_code": "FRA", "abbrev": "ASA", "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.", "administrator": "CEO: David Cavaillolès", "founding_year": "1980", "launchers": "Ariane | Vega", "spacecraft": "", "launch_library_url": null, "total_launch_count": 319, "consecutive_successful_launches": 7, "successful_launches": 304, "failed_launches": 15, "pending_launches": 48, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.arianespace.com", "wiki_url": "http://en.wikipedia.org/wiki/Arianespace", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg" }, "rocket": { "id": 8433, "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": 7022, "name": "CO3D & MicroCarb", "description": "CO3D is a CNES-Airbus Defence & Space constellation of four small satellites designed to map the globe in 3D from low Earth to serve public and private sector needs. Microcarb is a small satellite designed to map sources and sinks of carbon dioxide (CO2)—the most important greenhouse gas — on a global scale.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [ { "id": 178, "url": "https://ll.thespacedevs.com/2.2.0/agencies/178/?format=api", "name": "Airbus Defence and Space", "featured": false, "type": "Multinational", "country_code": "FRA,ITA,DEU,ESP,GBR", "abbrev": "AIRDS", "description": "Airbus Defence and Space is a division of Airbus responsible for defence and aerospace products and services. The division was formed in January 2014 during the corporate restructuring of European Aeronautic Defence and Space (EADS), and comprises the former Airbus Military, Astrium, and Cassidian divisions. It is the world's second largest space company after Boeing and one of the top ten defence companies in the world.", "administrator": "CEO: Michael Schoellhorn", "founding_year": "2014", "launchers": "Ariane", "spacecraft": "ATV | Columbus | Orion ESM", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.airbus.com/en/products-services/space", "wiki_url": "https://en.wikipedia.org/wiki/Airbus_Defence_and_Space", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/airbus2520defence2520and2520space_logo_20190207032423.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/airbus_defence__image_20250211203957.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/airbus_defence__image_20250210154159.jpeg" }, { "id": 46, "url": "https://ll.thespacedevs.com/2.2.0/agencies/46/?format=api", "name": "National Center of Space Research", "featured": false, "type": "Government", "country_code": "FRA", "abbrev": "CNES", "description": "The National Center of Space Research, or CNES, is a French National Agency in charge of France's space program. In partnership with the US and Russia, they have put 10 people in space. CNES works in tandem with the larger ESA to develop the Ariane 5 and work on other probes and satellites. They are working with Germany to develop a cheaper and more efficient reusable rocket, which hopefully will be ready to fly by 2026.", "administrator": "Interim CEO: Lionel Suchet", "founding_year": "1961", "launchers": "Ariane 5", "spacecraft": "Mars/Venus Express | Rosetta", "launch_library_url": null, "total_launch_count": 14, "consecutive_successful_launches": 3, "successful_launches": 12, "failed_launches": 2, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.cnes.fr/", "wiki_url": "http://en.wikipedia.org/wiki/CNES", "logo_url": null, "image_url": null, "nation_url": null } ], "info_urls": [ { "priority": 10, "source": "cnes.fr", "title": "CO3D | CNES", "description": "A constellation to map the world in 3D", "feature_image": null, "url": "https://cnes.fr/en/projects/co3d", "type": { "id": 1, "name": "Official Page" }, "language": { "id": 1, "name": "English", "code": "en" } } ], "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": 6981, "location_launch_attempt_count": 326, "pad_launch_attempt_count": 53, "agency_launch_attempt_count": 320, "orbital_launch_attempt_count_year": 132, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 3, "pad_turnaround": "P92DT14H44M8S", "mission_patches": [], "type": "detailed" }
