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/3b94ad50-3505-496e-8a95-b0bc4c0dadc6/?format=api
{ "id": "3b94ad50-3505-496e-8a95-b0bc4c0dadc6", "url": "https://lldev.thespacedevs.com/2.2.0/launch/3b94ad50-3505-496e-8a95-b0bc4c0dadc6/?format=api", "slug": "themis-demonstrator-t1h-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Themis Demonstrator | T1H-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-19T09:54:25Z", "updates": [ { "id": 12265, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch", "info_url": "https://www.esa.int/Enabling_Support/Space_Transportation/Themis", "created_by": "Nosu", "created_on": "2025-09-16T09:15:00Z" } ], "net": "2025-12-31T00:00:00Z", "net_precision": { "id": 11, "name": "Quarter 4", "abbrev": "Q4", "description": "The T-0 is expected in the fourth quarter of the given year." }, "window_end": "2025-12-31T00:00:00Z", "window_start": "2025-12-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 27, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/27/?format=api", "name": "European Space Agency", "featured": false, "type": "Multinational", "country_code": "FRA,ITA,DEU,ESP,CHE,GBR,AUT,SWE,BEL,PRT,NLD,HUN,POL,DNK,CZE,ROU,NOR,FIN,GRC,EST,IRL,LUX,SVN", "abbrev": "ESA", "description": "The European Space Agency is an intergovernmental organisation of 22 member states. Established in 1975 and headquartered in Paris, France, ESA has a worldwide staff of about 2,000 employees.\r\n\r\nESA's space flight programme includes human spaceflight (mainly through participation in the International Space Station program); the launch and operation of unmanned exploration missions to other planets and the Moon; Earth observation, science and telecommunication; designing launch vehicles; and maintaining a major spaceport, the Guiana Space Centre at Kourou, French Guiana.", "administrator": "Director General: Josef Aschbacher", "founding_year": "1975", "launchers": "Ariane | Vega", "spacecraft": "Space Rider", "launch_library_url": null, "total_launch_count": 7, "consecutive_successful_launches": 5, "successful_launches": 6, "failed_launches": 1, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.esa.int/", "wiki_url": "https://en.wikipedia.org/wiki/European_Space_Agency", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/esa_patch_float_image_20250211192109.png", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png" }, "rocket": { "id": 8717, "configuration": { "id": 523, "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/523/?format=api", "name": "Themis Demonstrator", "active": true, "reusable": true, "description": "Themis is an ESA rocket prototype – a flagship European demonstrator for low-cost rocket recovery and reuse technologies. Powered by the reusable, methane-fuelled engine Prometheus, it is developed with ArianeGroup as prime contractor and building on decades of European research and experience in rocketry and space operations, Themis is designed to launch, land vertically and live on for another mission.", "family": "", "full_name": "Themis Demonstrator", "manufacturer": { "id": 1044, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/1044/?format=api", "name": "ArianeGroup", "featured": false, "type": "Commercial", "country_code": "FRA", "abbrev": "AG", "description": "ArianeGroup (formerly Airbus Safran Launchers) is an aerospace company based in France. A joint venture between Airbus and Safran, the company was founded in 2015 and is headquartered in Issy-les-Moulineaux. It consists of three core arms: aerospace, defence and security.", "administrator": "CEO: Martin Sion", "founding_year": "2015", "launchers": "Ariane", "spacecraft": "", "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.ariane.group/", "wiki_url": "https://en.wikipedia.org/wiki/ArianeGroup", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/arianegroup_logo_20221130111224.PNG", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/arianegroup_nation_20230802053255.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 1, "max_stage": 1, "length": 28.0, "diameter": 3.5, "maiden_flight": null, "launch_cost": null, "launch_mass": 170, "leo_capacity": null, "gto_capacity": null, "to_thrust": 980, "apogee": 20, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/themis_demonstr_image_20250916085603.jpg", "info_url": "https://www.esa.int/Enabling_Support/Space_Transportation/Themis", "wiki_url": "https://en.wikipedia.org/wiki/Themis_programme", "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": 808, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 235, "url": "https://lldev.thespacedevs.com/2.2.0/launcher/235/?format=api", "details": "T1H, which stands for Themis 1-Engine Hop, is the first Themis demonstrator flight model, designed for low-altitude hop tests at the Esrange Space Center in Sweden.", "flight_proven": false, "serial_number": "T1H", "status": "active", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/themis_t1h_on_t_image_20250919095336.jpg", "successful_landings": 0, "attempted_landings": 0, "flights": 0, "last_launch_date": null, "first_launch_date": null }, "landing": { "id": 1702, "attempt": true, "success": null, "description": "The Themis T1H demonstrator will attempt a soft vertical landing back at its launch site.", "downrange_distance": 0.0, "location": { "id": 58, "name": "Launch Complex 3 Landing Pad", "abbrev": "LC3LP", "description": "40x40m landing pad at Esrange's Launch Complex 3.", "location": { "id": 178, "url": "https://lldev.thespacedevs.com/2.2.0/location/178/?format=api", "name": "Esrange Space Center", "country_code": "SWE", "description": "Esrange Space Center is a rocket range and research centre located about 40 kilometers east of the town of Kiruna in northern Sweden. It is a base for scientific research with high-altitude balloons, investigation of the aurora borealis, sounding rocket launches, and satellite tracking. Built in 1964 by ESRO, one of the predecessors of the European Space Agency, the site is currently operated by the Swedish Space Corporation. An orbital launch complex, LC-3, has been built in the early 2020s.", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_esrange_space_center_20241208021356.jpg", "timezone_name": "Europe/Stockholm", "total_launch_count": 0, "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": 7310, "name": "T1H-1", "description": "First low-altitude hop test of a Themis demonstrator, with a targeted altitude up to 100 m.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" }, "agencies": [ { "id": 27, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/27/?format=api", "name": "European Space Agency", "featured": false, "type": "Multinational", "country_code": "FRA,ITA,DEU,ESP,CHE,GBR,AUT,SWE,BEL,PRT,NLD,HUN,POL,DNK,CZE,ROU,NOR,FIN,GRC,EST,IRL,LUX,SVN", "abbrev": "ESA", "description": "The European Space Agency is an intergovernmental organisation of 22 member states. Established in 1975 and headquartered in Paris, France, ESA has a worldwide staff of about 2,000 employees.\r\n\r\nESA's space flight programme includes human spaceflight (mainly through participation in the International Space Station program); the launch and operation of unmanned exploration missions to other planets and the Moon; Earth observation, science and telecommunication; designing launch vehicles; and maintaining a major spaceport, the Guiana Space Centre at Kourou, French Guiana.", "administrator": "Director General: Josef Aschbacher", "founding_year": "1975", "launchers": "Ariane | Vega", "spacecraft": "Space Rider", "launch_library_url": null, "total_launch_count": 7, "consecutive_successful_launches": 5, "successful_launches": 6, "failed_launches": 1, "pending_launches": 1, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.esa.int/", "wiki_url": "https://en.wikipedia.org/wiki/European_Space_Agency", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/esa_patch_float_image_20250211192109.png", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 239, "url": "https://lldev.thespacedevs.com/2.2.0/pad/239/?format=api", "agency_id": 1044, "name": "Launch Complex 3B", "description": "Launch complex for Themis test flights at Esrange.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Esrange#Reusable_Rocket_Testing", "map_url": "https://www.google.com/maps?q=67.877368,21.165001", "latitude": "67.877368", "longitude": "21.165001", "location": { "id": 178, "url": "https://lldev.thespacedevs.com/2.2.0/location/178/?format=api", "name": "Esrange Space Center", "country_code": "SWE", "description": "Esrange Space Center is a rocket range and research centre located about 40 kilometers east of the town of Kiruna in northern Sweden. It is a base for scientific research with high-altitude balloons, investigation of the aurora borealis, sounding rocket launches, and satellite tracking. Built in 1964 by ESRO, one of the predecessors of the European Space Agency, the site is currently operated by the Swedish Space Corporation. An orbital launch complex, LC-3, has been built in the early 2020s.", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_esrange_space_center_20241208021356.jpg", "timezone_name": "Europe/Stockholm", "total_launch_count": 0, "total_landing_count": 0 }, "country_code": "SWE", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_launch_complex_3b_20250916091141.jpg", "total_launch_count": 0, "orbital_launch_attempt_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/themis_t1h_on_t_image_20250919095336.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 1, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 8, "orbital_launch_attempt_count_year": 0, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P0D", "mission_patches": [], "type": "detailed" }
