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/9b851dfd-0507-41e9-9827-3da6cbb42b21/?format=api
{ "id": "9b851dfd-0507-41e9-9827-3da6cbb42b21", "url": "https://ll.thespacedevs.com/2.2.0/launch/9b851dfd-0507-41e9-9827-3da6cbb42b21/?format=api", "slug": "delta-iv-heavy-nrol-49-kh-11-usa-224", "flightclub_url": null, "r_spacex_api_id": null, "name": "Delta IV Heavy | NROL-49 (KH-11) (USA-224)", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-06-15T13:29:46Z", "updates": [], "net": "2011-01-20T21:10:30Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2011-01-20T21:10:30Z", "window_start": "2011-01-20T21:10:30Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "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" }, "rocket": { "id": 1507, "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": { "id": 6795, "name": "NROL-49 (KH-11) (USA-224)", "description": "Classified payload for the U.S. National Reconnaissance Office.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [ { "id": 181, "url": "https://ll.thespacedevs.com/2.2.0/agencies/181/?format=api", "name": "National Reconnaissance Office", "featured": false, "type": "Government", "country_code": "USA", "abbrev": "NRO", "description": "The National Reconnaissance Office (NRO) is a member of the United States Intelligence Community and an agency of the United States Department of Defense which designs, builds, launches, and operates the reconnaissance satellites of the U.S. federal government, and provides satellite intelligence to several government agencies, particularly signals intelligence (SIGINT) to the NSA, imagery intelligence (IMINT) to the NGA, and measurement and signature intelligence (MASINT) to the DIA.", "administrator": "Director: Christopher Scolese", "founding_year": "1961", "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": "http://www.nro.gov/", "wiki_url": "https://en.wikipedia.org/wiki/National_Reconnaissance_Office", "logo_url": null, "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520reconnaissance2520office_nation_20240228092125.png" } ], "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": 807, "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": [ { "priority": 0, "source": null, "publisher": null, "title": "Delta IV NROL-49 Launch Highlights", "description": "The first West Coast Delta IV Heavy lifts off from Space Launch Complex-6 carrying the NROL-49 Mission.", "feature_image": "https://i.ytimg.com/vi/tWm1jUC5Ags/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=tWm1jUC5Ags", "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_20240313100946.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5108, "location_launch_attempt_count": 645, "pad_launch_attempt_count": 7, "agency_launch_attempt_count": 47, "orbital_launch_attempt_count_year": 2, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P1538DT7H17M30S", "mission_patches": [ { "id": 453, "name": "Delta IV Heavy | NROL-49 (KH-11) (USA-224) Patch", "priority": 9, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/delta2520iv25_mission_patch_20211031044044.png", "agency": { "id": 181, "url": "https://ll.thespacedevs.com/2.2.0/agencies/181/?format=api", "name": "National Reconnaissance Office", "type": "Government" } } ], "type": "detailed" }
