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/40413059-61e7-4ae4-ad16-e03c08b4aea3/?format=api
{ "id": "40413059-61e7-4ae4-ad16-e03c08b4aea3", "url": "https://ll.thespacedevs.com/2.2.0/launch/40413059-61e7-4ae4-ad16-e03c08b4aea3/?format=api", "slug": "delta-7326-95-genesis", "flightclub_url": null, "r_spacex_api_id": null, "name": "Delta 7326-9.5 | Genesis", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-12-31T12:25:53Z", "updates": [], "net": "2001-08-08T16:13:40Z", "net_precision": null, "window_end": "2001-08-08T16:13:40Z", "window_start": "2001-08-08T16:13:40Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 161, "url": "https://ll.thespacedevs.com/2.2.0/agencies/161/?format=api", "name": "United States Air Force", "featured": false, "type": "Government", "country_code": "USA", "abbrev": "USAF", "description": "The United States Air Force (USAF) is the air service branch of the United States Armed Forces, and is one of the eight uniformed services of the United States. Originally created on 1 August 1907, as a part of the United States Army Signal Corps, the USAF was established as a separate branch of the United States Armed Forces in 1947 with the enactment of the National Security Act of 1947.", "administrator": "Commander-in-Chief: President of the US", "founding_year": "1947", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 1078, "consecutive_successful_launches": 68, "successful_launches": 972, "failed_launches": 106, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.af.mil", "wiki_url": "http://en.wikipedia.org/wiki/United_States_Air_Force", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_logo_20230804084626.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/united2520states2520air2520force_nation_20230804085132.jpg" }, "rocket": { "id": 7052, "configuration": { "id": 302, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/302/?format=api", "name": "Delta II", "active": false, "reusable": false, "description": "Delta II was an expendable launch system, originally designed and built by McDonnell Douglas. Delta II was part of the Delta rocket family and entered service in 1989. Delta II vehicles included the Delta 6000, and the two later Delta 7000 variants (\"Light\" and \"Heavy\"). The rocket flew its final mission ICESat-2 on 15 September 2018, earning the launch vehicle a streak of 100 successful missions in a row, with the last failure being GPS IIR-1 in 1997.", "family": "Delta", "full_name": "Delta II 7326-9.5", "manufacturer": { "id": 153, "url": "https://ll.thespacedevs.com/2.2.0/agencies/153/?format=api", "name": "McDonnell Douglas", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "MDC", "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": "http://en.wikipedia.org/wiki/McDonnell_Douglas", "logo_url": null, "image_url": null, "nation_url": null }, "program": [], "variant": "7326-9.5", "alias": "", "min_stage": 4, "max_stage": 4, "length": 38.4, "diameter": 2.44, "maiden_flight": "1998-10-24", "launch_cost": null, "launch_mass": 155, "leo_capacity": null, "gto_capacity": null, "to_thrust": 2500, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Delta_II", "total_launch_count": 3, "consecutive_successful_launches": 3, "successful_launches": 3, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 5441, "name": "Genesis", "description": "Launch delayed from February 10 and July 30. The Genesis probe flew to the Earth-Sun L1 Lagrangian point and spend two years collecting samples of the solar wind. The collected samples were to be physically returned to Earth in a sample return capsule (air-snatch recovery was planned over Utah) and analysed in ground-based laboratories. On September 8, 2004, the Genesis space probe became the first spacecraft to return from beyond lunar orbit to the Earth's surface. The Genesis Sample Return Capsule separated from the spacecraft on September 8, 66,000 km above the Earth. The capsule successfully re-entered the atmosphere over Oregon at 11 km/s, but a wiring error resulted in the drogue parachute release mortar failing to fire at 33 km altitude. The capsule crashed to earth at 90 m/s in the Dugway Proving Ground at 40 07 40 N 113 30 29 W. Although the vehicle was smashed, some of the samples could be retrieved.", "launch_designator": null, "type": "Planetary Science", "orbit": { "id": 5, "name": "Heliocentric L1", "abbrev": "L1-point" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 14, "url": "https://ll.thespacedevs.com/2.2.0/pad/14/?format=api", "agency_id": null, "name": "Space Launch Complex 17A", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Space_Launch_Complex_17", "map_url": "https://www.google.com/maps?q=28.4472,-80.565", "latitude": "28.4472", "longitude": "-80.565", "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_14_20200803143451.jpg", "total_launch_count": 145, "orbital_launch_attempt_count": 145 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": null, "infographic": null, "program": [ { "id": 33, "url": "https://ll.thespacedevs.com/2.2.0/program/33/?format=api", "name": "Discovery Program", "description": "The Discovery Program is a series of Solar System exploration missions funded by the U.S. National Aeronautics and Space Administration (NASA) through its Planetary Missions Program Office. The cost of each mission is capped at a lower level than missions from NASA's New Frontiers or Flagship Programs. As a result, Discovery missions tend to be more focused on a specific scientific goal rather than serving a general purpose.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/discovery2520p_program_20231231122246.jpeg", "start_date": "1990-01-01T00:00:00Z", "end_date": null, "info_url": "https://www.nasa.gov/planetarymissions/discovery-program/", "wiki_url": "https://en.wikipedia.org/wiki/Discovery_Program", "mission_patches": [], "type": { "id": 5, "name": "Exploration" } } ], "orbital_launch_attempt_count": 4486, "location_launch_attempt_count": 595, "pad_launch_attempt_count": 130, "agency_launch_attempt_count": 1036, "orbital_launch_attempt_count_year": 34, "location_launch_attempt_count_year": 9, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 7, "pad_turnaround": "P123DT1H11M18S", "mission_patches": [], "type": "detailed" }
