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/b97a54e5-5c6f-4f85-bcf3-69da17fa9682/?format=api
{ "id": "b97a54e5-5c6f-4f85-bcf3-69da17fa9682", "url": "https://ll.thespacedevs.com/2.0.0/launch/b97a54e5-5c6f-4f85-bcf3-69da17fa9682/?format=api", "launch_library_id": null, "slug": "terran-r-mars-lander", "name": "Terran R | Mars Lander", "status": { "id": 2, "name": "TBD" }, "net": "2026-12-31T00:00:00Z", "window_end": "2026-12-31T00:00:00Z", "window_start": "2026-12-31T00:00:00Z", "inhold": false, "tbdtime": true, "tbddate": true, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 266, "url": "https://ll.thespacedevs.com/2.0.0/agencies/266/?format=api", "name": "Relativity Space", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "RS", "description": "Relativity Space is an American aerospace manufacturing company headquartered in Los Angeles, California. It was founded in 2015 by Tim Ellis and Jordan Noone. Relativity Space is developing manufacturing technologies, launch vehicles and rocket engines for commercial orbital launch services.", "administrator": "CEO: Tim Ellis", "founding_year": "2015", "launchers": "Terran", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 1, "pending_launches": 2, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.relativityspace.com/", "wiki_url": "https://en.wikipedia.org/wiki/Relativity_Space", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/relativity_spac_image_20240325080842.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/relativity_spac_image_20240325081000.jpg" }, "rocket": { "id": 7614, "configuration": { "id": 482, "launch_library_id": null, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/482/?format=api", "name": "Terran R", "description": "Terran R is a medium-lift 2-stage \r\nlaunch vehicle developed by Relativity Space is the first fully-reusable, entirely 3D printed orbital launch vehicle.", "family": "Terran", "full_name": "Terran R", "manufacturer": { "id": 266, "url": "https://ll.thespacedevs.com/2.0.0/agencies/266/?format=api", "name": "Relativity Space", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "RS", "description": "Relativity Space is an American aerospace manufacturing company headquartered in Los Angeles, California. It was founded in 2015 by Tim Ellis and Jordan Noone. Relativity Space is developing manufacturing technologies, launch vehicles and rocket engines for commercial orbital launch services.", "administrator": "CEO: Tim Ellis", "founding_year": "2015", "launchers": "Terran", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 1, "pending_launches": 2, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.relativityspace.com/", "wiki_url": "https://en.wikipedia.org/wiki/Relativity_Space", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/relativity_spac_image_20240325080842.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/relativity_spac_image_20240325081000.jpg" }, "program": [], "variant": "R", "alias": "", "min_stage": 2, "max_stage": 2, "length": 66.0, "diameter": 5.5, "maiden_flight": null, "launch_mass": null, "leo_capacity": 20000, "gto_capacity": null, "to_thrust": 9400, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/terran_r_image_20220912002151.png", "info_url": "https://www.relativityspace.com/rockets", "wiki_url": "https://en.wikipedia.org/wiki/Relativity_Space#Terran_R", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 2 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6104, "launch_library_id": null, "name": "Mars Lander", "description": "Impulse Space's Mars Lander is designed to support research and development needed for human exploration of Mars.", "launch_designator": null, "type": "Planetary Science", "orbit": { "id": 19, "name": "Mars Orbit", "abbrev": "Mars" } }, "pad": { "id": 92, "url": "https://ll.thespacedevs.com/2.0.0/pad/92/?format=api", "agency_id": 161, "name": "Launch Complex 16", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Launch_Complex_16", "map_url": "https://www.google.com/maps?q=28.501626,-80.5518", "latitude": "28.501626", "longitude": "-80.5518", "location": { "id": 12, "url": "https://ll.thespacedevs.com/2.0.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "total_launch_count": 1020, "total_landing_count": 64 }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_92_20200803143523.jpg", "total_launch_count": 1 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/terran2520r25_image_20220719142358.png", "infographic": null, "program": [], "orbital_launch_attempt_count": 7199, "location_launch_attempt_count": 1108, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 3, "orbital_launch_attempt_count_year": 86, "location_launch_attempt_count_year": 33, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2 }
