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/29cf6d14-08cd-468d-ba68-86640439f17e/?format=api
{ "id": "29cf6d14-08cd-468d-ba68-86640439f17e", "url": "https://ll.thespacedevs.com/2.2.0/launch/29cf6d14-08cd-468d-ba68-86640439f17e/?format=api", "slug": "delta-iv-m42-gps-iii-sv02", "flightclub_url": null, "r_spacex_api_id": null, "name": "Delta IV M+(4,2) | GPS III SV02", "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-30T10:54:14Z", "updates": [], "net": "2019-08-22T13:06:00Z", "net_precision": null, "window_end": "2019-08-22T13:27:00Z", "window_start": "2019-08-22T13:00:30Z", "probability": 80, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": "#GPSIIISV02", "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": "Interim CEO: John Elbon", "founding_year": "2006", "launchers": "Atlas | Delta | Vulcan", "spacecraft": "", "launch_library_url": null, "total_launch_count": 171, "consecutive_successful_launches": 171, "successful_launches": 171, "failed_launches": 0, "pending_launches": 40, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.ulalaunch.com/", "wiki_url": "https://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": 101, "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": "Interim CEO: John Elbon", "founding_year": "2006", "launchers": "Atlas | Delta | Vulcan", "spacecraft": "", "launch_library_url": null, "total_launch_count": 171, "consecutive_successful_launches": 171, "successful_launches": 171, "failed_launches": 0, "pending_launches": 40, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.ulalaunch.com/", "wiki_url": "https://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": 984, "name": "GPS III SV02 \"Magellan\"", "description": "GPS-IIIA (Global Positioning System) is the first evolution stage of the third generation of the GPS satellites. It consists of the first ten (known as \"tranche\") of GPS III satellites.", "launch_designator": null, "type": "Navigation", "orbit": { "id": 12, "name": "Medium Earth Orbit", "abbrev": "MEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "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": 1085, "total_landing_count": 71 }, "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": "youtube.com", "publisher": "Space Launch Now", "title": "Watch the final launch of a Delta IV Medium - GPSIII SV02!", "description": "LIKE and SUBSCRIBE if you enjoyed this video!\n\nLaunch Details: https://spacelaunchnow.me/launch/delta-iv-m42-gps-iii-sv02-1528/\n\nGPS-IIIA (Global Positioning System) is the first evolution stage of th...", "feature_image": "https://i.ytimg.com/vi/NOkaL3zLvxI/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=NOkaL3zLvxI", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2019-08-22T14:13:49Z", "end_time": "2019-08-22T14:17:10Z" }, { "priority": 0, "source": "youtube.com", "publisher": "United Launch Alliance", "title": "Live Broadcast: Delta IV GPS III Magellan", "description": "Watch live as ULA's Delta IV rocket lifts off from Cape Canaveral with the GPS III SV02 \"Magellan\" mission for the U.S. Air Force Space and Missile Systems Center.", "feature_image": "https://i.ytimg.com/vi/0AgiyxDoXtE/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=0AgiyxDoXtE", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2019-08-22T12:26:32Z", "end_time": "2019-08-22T13:24:04Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta_iv_m252b_image_20220302002926.jpeg", "infographic": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/infographic_images/delta2520iv25_infographic_20200806035622.png", "program": [ { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/program/29/?format=api", "name": "Global Positioning System", "description": "The Global Positioning System (GPS), originally Navstar GPS, is a satellite-based radio navigation system owned by the United States government and operated by the United States Space Force. It is one of the global navigation satellite systems (GNSS) that provide geolocation and time information to a GPS receiver anywhere on or near the Earth where there is an unobstructed line of sight to four or more GPS satellites.", "agencies": [ { "id": 1041, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1041/?format=api", "name": "United States Space Force", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/global2520posi_program_20231229182501.png", "start_date": "1978-02-22T00:00:00Z", "end_date": null, "info_url": "https://www.gps.gov/", "wiki_url": "https://en.wikipedia.org/wiki/Global_Positioning_System", "mission_patches": [], "type": { "id": 4, "name": "Navigation Constellation" } } ], "orbital_launch_attempt_count": 5881, "location_launch_attempt_count": 787, "pad_launch_attempt_count": 37, "agency_launch_attempt_count": 136, "orbital_launch_attempt_count_year": 61, "location_launch_attempt_count_year": 9, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P159DT12H40M", "mission_patches": [ { "id": 35, "name": "GPS III USAF Mission Patch", "priority": 9, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/gps2520iii252_mission_patch_20210608180509.png", "agency": { "id": 161, "url": "https://ll.thespacedevs.com/2.2.0/agencies/161/?format=api", "name": "United States Air Force", "type": "Government" } }, { "id": 57, "name": "GPS-III SV01 SpaceX Mission Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/gps-iii2520sv0_mission_patch_20210616192903.png", "agency": { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } } ], "type": "detailed" }
