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/46339a1d-367c-4903-b827-8eaa12d66391/?format=api
{ "id": "46339a1d-367c-4903-b827-8eaa12d66391", "url": "https://lldev.thespacedevs.com/2.0.0/launch/46339a1d-367c-4903-b827-8eaa12d66391/?format=api", "launch_library_id": null, "slug": "terran-r-mars-orbiter", "name": "Terran R | Mars Orbiter", "status": { "id": 2, "name": "TBD" }, "net": "2028-12-31T00:00:00Z", "window_end": "2028-12-31T00:00:00Z", "window_start": "2028-12-31T00:00:00Z", "inhold": false, "tbdtime": true, "tbddate": true, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 266, "url": "https://lldev.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": 4, "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-dev.nyc3.digitaloceanspaces.com/media/images/relativity_spac_image_20240325080842.png", "image_url": null, "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/relativity_spac_image_20240325081000.jpg" }, "rocket": { "id": 9064, "configuration": { "id": 482, "launch_library_id": null, "url": "https://lldev.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://lldev.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": 4, "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-dev.nyc3.digitaloceanspaces.com/media/images/relativity_spac_image_20240325080842.png", "image_url": null, "nation_url": "https://thespacedevs-dev.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-dev.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": 4 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7659, "launch_library_id": null, "name": "Mars Orbiter", "description": "Mars science and telecommunications orbiter, with a NASA-developed atmospheric instrument suite called Aeolus. It includes a Doppler wind and temperature sensor, thermal limb sounder, surface radiometric sensors and a wide-field camera.", "launch_designator": null, "type": "Planetary Science", "orbit": { "id": 19, "name": "Mars Orbit", "abbrev": "Mars" } }, "pad": { "id": 92, "url": "https://lldev.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://lldev.thespacedevs.com/2.0.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "total_launch_count": 1132, "total_landing_count": 83 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_92_20200803143523.jpg", "total_launch_count": 1 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/relativity_spac_image_20260618064224.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7740, "location_launch_attempt_count": 1235, "pad_launch_attempt_count": 5, "agency_launch_attempt_count": 5, "orbital_launch_attempt_count_year": 55, "location_launch_attempt_count_year": 17, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2 }
