Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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'
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.0.0/launch/241e01b2-c9ff-4185-ad78-f48d441ff919/?format=api
{ "id": "241e01b2-c9ff-4185-ad78-f48d441ff919", "url": "https://ll.thespacedevs.com/2.0.0/launch/241e01b2-c9ff-4185-ad78-f48d441ff919/?format=api", "launch_library_id": null, "slug": "callisto-flight-1", "name": "Callisto | Flight 1", "status": { "id": 2, "name": "TBD" }, "net": "2027-12-31T00:00:00Z", "window_end": "2027-12-31T00:00:00Z", "window_start": "2027-12-31T00:00:00Z", "inhold": false, "tbdtime": true, "tbddate": true, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 46, "url": "https://ll.thespacedevs.com/2.0.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": "CEO: François Jacq", "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": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.cnes.fr/", "wiki_url": "https://en.wikipedia.org/wiki/CNES", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cnes_logo_image_20250722090832.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cnes_toulouse_e_image_20250722090314.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cnes_social_log_image_20250722090952.jpg" }, "rocket": { "id": 8718, "configuration": { "id": 524, "launch_library_id": null, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/524/?format=api", "name": "Callisto", "description": "Callisto is a demonstrator designed to conduct flight testing and mature the complex technologies required to return a launcher to Earth, as well as refurbishment operations between flights, and to precisely cost an operational European launcher with a reusable first stage (it is not intended to become an operational launcher). Standing for “Cooperative Action Leading to Launcher Innovation in Stage Toss-back Operations”, Callisto is a project being pursued with the Japan Aerospace Exploration Agency (JAXA) and the German space agency DLR. A large number of international contractors are also contributing to the experiment, among them ArianeGroup and Mitsubishi Heavy Industries.", "family": "", "full_name": "Callisto", "manufacturer": { "id": 46, "url": "https://ll.thespacedevs.com/2.0.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": "CEO: François Jacq", "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": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.cnes.fr/", "wiki_url": "https://en.wikipedia.org/wiki/CNES", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cnes_logo_image_20250722090832.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cnes_toulouse_e_image_20250722090314.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cnes_social_log_image_20250722090952.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 1, "max_stage": 1, "length": 13.0, "diameter": 1.1, "maiden_flight": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "to_thrust": 46, "apogee": 20, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/callisto_render_image_20250916093902.webp", "info_url": "https://cnes.fr/en/projects/callisto", "wiki_url": "https://en.wikipedia.org/wiki/CALLISTO", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 1 }, "launcher_stage": [ { "id": 809, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 237, "url": "https://ll.thespacedevs.com/2.0.0/launcher/237/?format=api", "details": "Callisto flight model", "flight_proven": false, "serial_number": "Callisto", "status": "active", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/callisto_render_image_20250916093902.webp", "successful_landings": 0, "attempted_landings": 0, "flights": 0, "last_launch_date": null, "first_launch_date": null }, "landing": { "id": 1703, "attempt": true, "success": null, "description": "The Callisto demonstrator will attempt to land back at the Diamant launch site after this flight", "location": { "id": 59, "name": "Diamant Launch Area Landing Pad", "abbrev": "DLALP", "description": "Landing pad for reusable first stages launched from the Diamant Launch Area.", "location": { "id": 13, "url": "https://ll.thespacedevs.com/2.0.0/location/13/?format=api", "name": "Guiana Space Centre, French Guiana", "country_code": "GUF", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "total_launch_count": 334, "total_landing_count": 0 }, "successful_landings": 0 }, "type": { "id": 2, "name": "Return to Launch Site", "abbrev": "RTLS", "description": "A return to launch site usually means that after stage separation the booster flips and does a burn back towards the launch site, landing near where it initially launched from." } }, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": null }, "mission": { "id": 7311, "launch_library_id": null, "name": "Flight 1", "description": "First test flight of the Callisto VTVL demonstrator.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" } }, "pad": { "id": 125, "url": "https://ll.thespacedevs.com/2.0.0/pad/125/?format=api", "agency_id": 46, "name": "Diamant Launch Area", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=5.2222222,-52.7758051", "latitude": "5.2222222", "longitude": "-52.7758051", "location": { "id": 13, "url": "https://ll.thespacedevs.com/2.0.0/location/13/?format=api", "name": "Guiana Space Centre, French Guiana", "country_code": "GUF", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "total_launch_count": 334, "total_landing_count": 0 }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_125_20200803143236.jpg", "total_launch_count": 8 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/callisto_render_image_20250916093902.webp", "infographic": null, "program": [], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 360, "pad_launch_attempt_count": 11, "agency_launch_attempt_count": 15, "orbital_launch_attempt_count_year": null, "location_launch_attempt_count_year": 17, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 1 }
