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/07715175-08e6-4c5c-bac4-3f190114079c/?format=api
{ "id": "07715175-08e6-4c5c-bac4-3f190114079c", "url": "https://ll.thespacedevs.com/2.2.0/launch/07715175-08e6-4c5c-bac4-3f190114079c/?format=api", "slug": "delta-iv-m42-nrol-22", "flightclub_url": null, "r_spacex_api_id": null, "name": "Delta IV M+(4,2) | NROL-22", "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-06-14T03:33:01Z", "updates": [], "net": "2006-06-28T03:33:00Z", "net_precision": null, "window_end": "2006-06-28T03:33:00Z", "window_start": "2006-06-28T03:33:00Z", "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": 7274, "configuration": { "id": 33, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/33/?format=api", "name": "Delta IV M+(4,2)", "active": false, "reusable": false, "description": "", "family": "Delta", "full_name": "Delta IV M+(4,2)", "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": "M+(4,2)", "alias": "", "min_stage": 2, "max_stage": 2, "length": 66.2, "diameter": 5.0, "maiden_flight": "2002-11-20", "launch_cost": "350000000", "launch_mass": 292, "leo_capacity": 11920, "gto_capacity": 6270, "to_thrust": 4200, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta_iv_m252b_image_20220302002926.jpeg", "info_url": "https://www.spacelaunchreport.com/delta4.html", "wiki_url": null, "total_launch_count": 15, "consecutive_successful_launches": 15, "successful_launches": 15, "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": 5663, "name": "NROL-22 (Trumpet 4)", "description": "These spacecraft are probably the replacement for the Trumpet SIGINT satellites operating in a Molniya orbit. As no name is known, these are referred here as \"Trumpet Follow On\". Possibly these satellites might be named Raven. These satellite most likely use a large, unfurlable dish antenna to collect the signals. Advances in both antenna and electronics technologies have allowed for a large reduction in size compared the Trumpet predecessors.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 7, "name": "High Earth Orbit", "abbrev": "HEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/pad/11/?format=api", "agency_id": null, "name": "Space Launch Complex 6", "description": "Space Launch Complex 6 at Vandenberg Space Force Base in California is a launch pad and support area. The site was originally developed starting in 1966, but no launches occurred until 1995, as it was repurposed sequentially for three programs that were subsequently cancelled. Initially to be used for Titan IIIM rockets and the Manned Orbiting Laboratory, these were cancelled before construction of SLC-6 was complete. The complex was later rebuilt to serve as the west coast launch site for the Space Shuttle, but went unused due to budget, safety and political considerations. The pad was subsequently used for four Athena rocket launches before being modified to support the Delta IV launch vehicle family, which used the pad for ten launches from 2006 until 2022. The last Delta IV launched in September 2022, and SpaceX leased SLC-6 in 2023 to convert it to launch Falcon 9 and Falcon Heavy starting in 2025.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vandenberg_Space_Launch_Complex_6", "map_url": "https://www.google.com/maps?q=34.5815,-120.6262", "latitude": "34.5815", "longitude": "-120.6262", "location": { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/location/11/?format=api", "name": "Vandenberg SFB, CA, USA", "country_code": "USA", "description": "Vandenberg Space Force Base is a United States Space Force Base in Santa Barbara County, California. Established in 1941, Vandenberg Space Force Base is a space launch base, launching spacecraft from the Western Range, and also performs missile testing. The United States Space Force's Space Launch Delta 30 serves as the host delta for the base, equivalent to an Air Force air base wing. In addition to its military space launch mission, Vandenberg Space Force Base also hosts space launches for civil and commercial space entities, such as NASA and SpaceX.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_11_20200803142416.jpg", "timezone_name": "America/Los_Angeles", "total_launch_count": 806, "total_landing_count": 26 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_11_20200803143550.jpg", "total_launch_count": 14, "orbital_launch_attempt_count": 14 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta_iv_m252b_image_20220302002926.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 4779, "location_launch_attempt_count": 626, "pad_launch_attempt_count": 5, "agency_launch_attempt_count": 1074, "orbital_launch_attempt_count_year": 29, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P2468DT9H11M52S", "mission_patches": [ { "id": 475, "name": "NROL-22 (Trumpet 4) Patch", "priority": 9, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/nrol-22252025_mission_patch_20211031044055.png", "agency": { "id": 181, "url": "https://ll.thespacedevs.com/2.2.0/agencies/181/?format=api", "name": "National Reconnaissance Office", "type": "Government" } } ], "type": "detailed" }
