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/2e37a196-f5f8-4496-96ae-63f4b6b27912/?format=api
{ "id": "2e37a196-f5f8-4496-96ae-63f4b6b27912", "url": "https://ll.thespacedevs.com/2.0.0/launch/2e37a196-f5f8-4496-96ae-63f4b6b27912/?format=api", "launch_library_id": null, "slug": "terran-r-intelsat-1", "name": "Terran R | Intelsat-1", "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": 8044, "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": 6591, "launch_library_id": null, "name": "Intelsat-1", "description": "First mission part of a multi-year, multi-launch agreement signed between Intelsat and Relativity Space in 2023.", "launch_designator": null, "type": "Communications", "orbit": { "id": 25, "name": "Unknown", "abbrev": "N/A" } }, "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/terran_r_image_20220912002151.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 }
