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/9536659f-bacc-4396-8bd4-04f8050cc92d/?format=api
{ "id": "9536659f-bacc-4396-8bd4-04f8050cc92d", "url": "https://ll.thespacedevs.com/2.2.0/launch/9536659f-bacc-4396-8bd4-04f8050cc92d/?format=api", "slug": "sl1-demo-flight", "flightclub_url": null, "r_spacex_api_id": null, "name": "SL1 | Demo Flight", "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-11-15T04:24:08Z", "updates": [ { "id": 12898, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://hyimpulse.de/Press_Release/Press%20Release_HyImpulse%20raises%2045%20million%20in%20funding.pdf", "created_by": "Cosmic_Penguin", "created_on": "2025-11-15T04: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": 1066, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1066/?format=api", "name": "HyImpulse", "featured": false, "type": "Private", "country_code": "DEU", "abbrev": "HYI", "description": "HyImpulse is a German private space launch enterprise headquartered in Neuenstadt am Kocher and developing a small launch vehicle designed around hybrid-propellant rockets. The company is a DLR spinoff founded in 2018 out of the chemical propulsion center of the German space agency's Lampoldshausen facility.", "administrator": "CEO: Mario Kobald", "founding_year": "2018", "launchers": "SR75 | SL1", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://hyimpulse.de/en/", "wiki_url": "https://en.wikipedia.org/wiki/HyImpulse", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hyimpulse_logo_20230818080330.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hyimpulse_nation_20230818080330.png" }, "rocket": { "id": 8798, "configuration": { "id": 531, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/531/?format=api", "name": "SL1", "active": true, "reusable": false, "description": "3-stage orbital launch vehicle developed by German private company HyImpulse, with capability of up to 600 kg to Low Earth Orbit. All 3 stages are powered by hybrid rocket motors using paraffin and liquid oxygen as fuel.", "family": "", "full_name": "SL1", "manufacturer": { "id": 1066, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1066/?format=api", "name": "HyImpulse", "featured": false, "type": "Private", "country_code": "DEU", "abbrev": "HYI", "description": "HyImpulse is a German private space launch enterprise headquartered in Neuenstadt am Kocher and developing a small launch vehicle designed around hybrid-propellant rockets. The company is a DLR spinoff founded in 2018 out of the chemical propulsion center of the German space agency's Lampoldshausen facility.", "administrator": "CEO: Mario Kobald", "founding_year": "2018", "launchers": "SR75 | SL1", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://hyimpulse.de/en/", "wiki_url": "https://en.wikipedia.org/wiki/HyImpulse", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hyimpulse_logo_20230818080330.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hyimpulse_nation_20230818080330.png" }, "program": [], "variant": "", "alias": "", "min_stage": 3, "max_stage": 3, "length": 33.0, "diameter": 2.2, "maiden_flight": null, "launch_cost": null, "launch_mass": null, "leo_capacity": 600, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/sl1_artist_impr_image_20251115042045.png", "info_url": "https://www.hyimpulse.de/en/products/5-project-3-mini-launcher", "wiki_url": "https://en.wikipedia.org/wiki/HyImpulse#Rockets", "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": [], "spacecraft_stage": null }, "mission": { "id": 7389, "name": "Demo Flight", "description": "First launch of HyImpulse's SL1 launch vehicle.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 237, "url": "https://ll.thespacedevs.com/2.2.0/pad/237/?format=api", "agency_id": null, "name": "Unknown Pad", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/SaxaVord_Spaceport", "map_url": "https://www.google.com/maps?q=60.8184,-0.7692", "latitude": "60.8184", "longitude": "-0.7692", "location": { "id": 157, "url": "https://ll.thespacedevs.com/2.2.0/location/157/?format=api", "name": "SaxaVord Spaceport", "country_code": "GBR", "description": "SaxaVord Spaceport is a UK spaceport located on the Lamba Ness peninsula on Unst, the most northerly of the inhabited Shetland Islands off the coast of Scotland. The site is near the RAF Saxa Vord radar station and the settlement of Skaw, adjacent to the Saxa Vord distillery.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_saxavord_spaceport_20211102161146.jpg", "timezone_name": "Europe/London", "total_launch_count": 0, "total_landing_count": 0 }, "country_code": "GBR", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_unknown_pad_20241227075133.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/sl1_artist_impr_image_20251115042045.png", "infographic": null, "program": [], "orbital_launch_attempt_count": 7409, "location_launch_attempt_count": 4, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 2, "orbital_launch_attempt_count_year": 60, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P365D", "mission_patches": [], "type": "detailed" }
