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/2e37a196-f5f8-4496-96ae-63f4b6b27912/?format=api
{ "id": "2e37a196-f5f8-4496-96ae-63f4b6b27912", "url": "https://ll.thespacedevs.com/2.2.0/launch/2e37a196-f5f8-4496-96ae-63f4b6b27912/?format=api", "slug": "terran-r-intelsat-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Terran R | Intelsat-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": "2023-10-12T15:19:43Z", "updates": [ { "id": 5398, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch NET 2026", "info_url": "https://spacenews.com/intelsat-signs-multi-launch-contract-with-relativity-space/", "created_by": "Nosu", "created_on": "2023-10-12T15:19:44Z" } ], "net": "2026-12-31T00:00:00Z", "net_precision": { "id": 14, "name": "Year", "abbrev": "Y", "description": "The T-0 is expected in the given year." }, "window_end": "2026-12-31T00:00:00Z", "window_start": "2026-12-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 266, "url": "https://ll.thespacedevs.com/2.2.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, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/482/?format=api", "name": "Terran R", "active": true, "reusable": true, "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.2.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_cost": 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, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6591, "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" }, "agencies": [ { "id": 206, "url": "https://ll.thespacedevs.com/2.2.0/agencies/206/?format=api", "name": "Intelsat", "featured": false, "type": "Commercial", "country_code": "LUX", "abbrev": "I", "description": null, "administrator": null, "founding_year": null, "launchers": "", "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": null, "wiki_url": "https://en.wikipedia.org/wiki/Intelsat", "logo_url": null, "image_url": null, "nation_url": null } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 92, "url": "https://ll.thespacedevs.com/2.2.0/pad/92/?format=api", "agency_id": 161, "name": "Launch Complex 16", "description": null, "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.2.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 1021, "total_landing_count": 64 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_92_20200803143523.jpg", "total_launch_count": 1, "orbital_launch_attempt_count": 1 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/terran_r_image_20220912002151.png", "infographic": null, "program": [], "orbital_launch_attempt_count": 7203, "location_launch_attempt_count": 1109, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 3, "orbital_launch_attempt_count_year": 88, "location_launch_attempt_count_year": 33, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P1378DT20H35M", "mission_patches": [], "type": "detailed" }
