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/6681c5ad-b2ae-49ef-83db-99dae77de9bd/?format=api
{ "id": "6681c5ad-b2ae-49ef-83db-99dae77de9bd", "url": "https://ll.thespacedevs.com/2.2.0/launch/6681c5ad-b2ae-49ef-83db-99dae77de9bd/?format=api", "slug": "delta-iv-heavy-demosat-and-3cs-1-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Delta IV Heavy | Demosat and 3CS-1 & 2", "status": { "id": 7, "name": "Launch was a Partial Failure", "abbrev": "Partial Failure", "description": "Either the launch vehicle reached orbit but did not deliver its payload in the targeted orbit, or an exceptional event made it impossible to consider the mission a success." }, "last_updated": "2023-06-14T17:43:27Z", "updates": [], "net": "2004-12-21T21:50:00Z", "net_precision": null, "window_end": "2004-12-21T21:50:00Z", "window_start": "2004-12-21T21:50:00Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "Two nanosats were lost after a first stage anomaly. Additionally, the mass simulator was placed into the wrong orbit.", "hashtag": null, "launch_service_provider": { "id": 80, "url": "https://ll.thespacedevs.com/2.2.0/agencies/80/?format=api", "name": "Boeing", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "BA", "description": "Boeing as a space agency has recently provided NASA with assistance on sending humans to the ISS from American with both their construction of the CST-100 Starliner crew capsule and their work on the SLS Avionics to return to the moon and beyond. Their ventures in GPS satellite systems and Tracking and Data Relay Satellites provide information about earth-orbiting craft to stations on the ground. They also enable research on the ISS and will be helping with the construction of the Lunar Gateway.", "administrator": "CEO: Kelly Ortberg", "founding_year": "1916", "launchers": "SLS", "spacecraft": "Starliner", "launch_library_url": null, "total_launch_count": 2, "consecutive_successful_launches": 0, "successful_launches": 1, "failed_launches": 1, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.boeing.com", "wiki_url": "http://en.wikipedia.org/wiki/Boeing", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/boeing_logo_20201128183345.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/boeing_nation_20230804083022.jpg" }, "rocket": { "id": 507, "configuration": { "id": 21, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/21/?format=api", "name": "Delta IV Heavy", "active": false, "reusable": false, "description": "The Delta IV Heavy (Delta 9250H) is an expendable heavy-lift launch vehicle, the largest type of the Delta IV family, and is the world's second highest-capacity rocket in operation. It is manufactured by United Launch Alliance and was first launched in 2004.", "family": "Delta", "full_name": "Delta IV Heavy", "manufacturer": { "id": 124, "url": "https://ll.thespacedevs.com/2.2.0/agencies/124/?format=api", "name": "United Launch Alliance", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "ULA", "description": "United Launch Alliance (ULA) is a joint venture of Lockheed Martin Space Systems and Boeing Defense, Space & Security. ULA was formed in December 2006 by combining the teams at these companies which provide spacecraft launch services to the government of the United States. ULA launches from both coasts of the US. They launch their Atlas V vehicle from LC-41 in Cape Canaveral and LC-3E at Vandeberg. Their Delta IV launches from LC-37 at Cape Canaveral and LC-6 at Vandenberg.", "administrator": "CEO: Tory Bruno", "founding_year": "2006", "launchers": "Atlas | Delta IV | Vulcan", "spacecraft": "CST-100 Starliner", "launch_library_url": null, "total_launch_count": 165, "consecutive_successful_launches": 165, "successful_launches": 165, "failed_launches": 0, "pending_launches": 44, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.ulalaunch.com/", "wiki_url": "http://en.wikipedia.org/wiki/United_Launch_Alliance", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_logo_20210412195953.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united_launch_a_image_20210412201210.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520launch2520alliance_nation_20230531043703.jpg" }, "program": [], "variant": "Heavy", "alias": "", "min_stage": 2, "max_stage": 2, "length": 72.0, "diameter": 5.0, "maiden_flight": "2004-12-21", "launch_cost": "350000000", "launch_mass": 733, "leo_capacity": 28370, "gto_capacity": 14210, "to_thrust": 8674, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta_iv_heavy_image_20210426103838.jpg", "info_url": "https://www.ulalaunch.com/rockets/delta-iv", "wiki_url": "https://en.wikipedia.org/wiki/Delta_IV_Heavy", "total_launch_count": 16, "consecutive_successful_launches": 15, "successful_launches": 15, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": null, "pad": { "id": 38, "url": "https://ll.thespacedevs.com/2.2.0/pad/38/?format=api", "agency_id": null, "name": "Space Launch Complex 37B", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_37", "map_url": "https://www.google.com/maps?q=28.5317,-80.56495", "latitude": "28.5317", "longitude": "-80.56495", "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": 1024, "total_landing_count": 64 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_38_20200803143515.jpg", "total_launch_count": 40, "orbital_launch_attempt_count": 40 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Delta IV Heavy inaugural launch", "description": "The first flight of a Delta IV Heavy launch vehicle featuring 3 CBCs or Common Booster Cores, each powered with a single, cryogenic RS-68 engine. The launch,...", "feature_image": "https://i.ytimg.com/vi/XB5_j1RYMYg/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=XB5_j1RYMYg", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta_iv_heavy_image_20210426103838.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 4691, "location_launch_attempt_count": 631, "pad_launch_attempt_count": 11, "agency_launch_attempt_count": 2, "orbital_launch_attempt_count_year": 4691, "location_launch_attempt_count_year": 13, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P479DT22H37M", "mission_patches": [], "type": "detailed" }
