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/241e01b2-c9ff-4185-ad78-f48d441ff919/?format=api
{ "id": "241e01b2-c9ff-4185-ad78-f48d441ff919", "url": "https://ll.thespacedevs.com/2.2.0/launch/241e01b2-c9ff-4185-ad78-f48d441ff919/?format=api", "slug": "callisto-flight-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Callisto | Flight 1", "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-09-16T11:24:15Z", "updates": [ { "id": 12266, "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/callisto", "created_by": "Nosu", "created_on": "2025-09-16T11:24:00Z" } ], "net": "2027-12-31T00:00:00Z", "net_precision": { "id": 14, "name": "Year", "abbrev": "Y", "description": "The T-0 is expected in the given year." }, "window_end": "2027-12-31T00:00:00Z", "window_start": "2027-12-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "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": "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, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/524/?format=api", "name": "Callisto", "active": true, "reusable": true, "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.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": "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_cost": 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, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [ { "id": 809, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 237, "url": "https://ll.thespacedevs.com/2.2.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", "downrange_distance": 0.0, "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.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": 327, "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, "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" }, "agencies": [ { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/agencies/29/?format=api", "name": "German Aerospace Center", "featured": false, "type": "Government", "country_code": "DEU", "abbrev": "DLR", "description": "The German Aerospace Center is Germany's Center for aerospace, energy, and transportation research. Their main work is as a contributor to the ESA. They have done work both in tandem with the US on Space Shuttle and the ISS, and also with other European Nations on missions like Space Lab and Mars Express.", "administrator": "Administrator: Anke Kaysser-Pyzalla", "founding_year": "1969", "launchers": "", "spacecraft": "Mars Express | Rosetta | Dawn", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.dlr.de/", "wiki_url": "https://en.wikipedia.org/wiki/German_Aerospace_Center", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/german2520aerospace2520center_logo_20230806164738.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/dlr_social_logo_image_20250916112302.jpg" }, { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "featured": true, "type": "Government", "country_code": "JPN", "abbrev": "JAXA", "description": "The Japan Aerospace Exploration Agency (JAXA) is Japan's national aero-space agency. Through the merger of three previously independent organizations, JAXA was formed on 1 October 2003. JAXA is responsible for research, technology development and the launch of satellites into orbit, and is involved in many more advanced missions, such as asteroid exploration and possible manned exploration of the Moon. JAXA launch their Epsilon vehicle from the Uchinoura Space Center and their H-II vehicles from the Tanegashima Space Center.", "administrator": "Administrator: Hiroshi Yamakawa", "founding_year": "2003", "launchers": "H-II", "spacecraft": "", "launch_library_url": null, "total_launch_count": 37, "consecutive_successful_launches": 2, "successful_launches": 33, "failed_launches": 4, "pending_launches": 2, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.jaxa.jp/", "wiki_url": "https://en.wikipedia.org/wiki/Japan_Aerospace_Exploration_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_logo_20190207032440.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_image_20190207032440.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/japan2520aerospace2520exploration2520agency_nation_20230531052930.png" }, { "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": "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" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 125, "url": "https://ll.thespacedevs.com/2.2.0/pad/125/?format=api", "agency_id": 46, "name": "Diamant Launch Area", "description": "", "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.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": 327, "total_landing_count": 0 }, "country_code": "GUF", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_125_20200803143236.jpg", "total_launch_count": 8, "orbital_launch_attempt_count": 8 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "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": 361, "pad_launch_attempt_count": 10, "agency_launch_attempt_count": 15, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 10, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P730D", "mission_patches": [], "type": "detailed" }
