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/d6449a4e-7059-4623-8b64-7e7a8a6985a5/?format=api
{ "id": "d6449a4e-7059-4623-8b64-7e7a8a6985a5", "url": "https://ll.thespacedevs.com/2.2.0/launch/d6449a4e-7059-4623-8b64-7e7a8a6985a5/?format=api", "slug": "atlas-v-n22-cst-100-starliner-orbital-flight-test", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas V N22 | CST-100 Starliner Orbital Flight Test", "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-14T17:42:22Z", "updates": [], "net": "2019-12-20T11:36:43Z", "net_precision": null, "window_end": "2019-12-20T11:36:43Z", "window_start": "2019-12-20T11:36:43Z", "probability": 80, "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": 164, "consecutive_successful_launches": 164, "successful_launches": 164, "failed_launches": 0, "pending_launches": 43, "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": 1375, "configuration": { "id": 166, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/166/?format=api", "name": "Atlas V N22", "active": true, "reusable": false, "description": "The Atlas V N22 is a crew rated variant of the Atlas V 422 - it sports two solid motor strap on boosters with two liquid fueled stages. It will be primarly used to support NASA's Commercial Crew program by taking the CST-100 to orbit.", "family": "Atlas", "full_name": "Atlas V N22", "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": 164, "consecutive_successful_launches": 164, "successful_launches": 164, "failed_launches": 0, "pending_launches": 43, "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": "V N22", "alias": "", "min_stage": 2, "max_stage": 2, "length": 58.0, "diameter": 3.8, "maiden_flight": "2019-12-20", "launch_cost": "110000000", "launch_mass": null, "leo_capacity": 13034, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas_v_n22_image_20210813082339.jpeg", "info_url": "https://www.ulalaunch.com/rockets/atlas-v", "wiki_url": "https://en.wikipedia.org/wiki/Atlas_V", "total_launch_count": 3, "consecutive_successful_launches": 3, "successful_launches": 3, "failed_launches": 0, "pending_launches": 6, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 414, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/414/?format=api", "mission_end": "2019-12-22T12:58:53Z", "destination": "International Space Station", "launch_crew": [ { "id": 3107, "role": { "id": 19, "role": "Anthropomorphic Test Device", "priority": 9 }, "astronaut": { "id": 641, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/641/?format=api", "name": "Rosie the Astronaut", "type": { "id": 6, "name": "Non-Human" }, "in_space": false, "time_in_space": "P8DT1H16M23S", "status": { "id": 1, "name": "Active" }, "agency": { "id": 80, "url": "https://ll.thespacedevs.com/2.2.0/agencies/80/?format=api", "name": "Boeing", "type": "Commercial" }, "date_of_birth": null, "date_of_death": null, "nationality": "Earthling", "twitter": null, "instagram": null, "bio": "Rosie the Astronaut is an Anthropomorphic Test Device (ATD), named after the iconic WWII character, Rosie the Riveter.\r\nIt will launch aboard the Boeing Starliner for its inaugural uncrewed flight to the International Space Station and back.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rosie2520the2520astronaut_image_20191204080725.jpg", "wiki": null, "last_flight": "2022-05-19T22:54:47Z", "first_flight": "2019-12-20T11:36:43Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 901, "role": { "id": 19, "role": "Anthropomorphic Test Device", "priority": 9 }, "astronaut": { "id": 641, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/641/?format=api", "name": "Rosie the Astronaut", "type": { "id": 6, "name": "Non-Human" }, "in_space": false, "time_in_space": "P8DT1H16M23S", "status": { "id": 1, "name": "Active" }, "agency": { "id": 80, "url": "https://ll.thespacedevs.com/2.2.0/agencies/80/?format=api", "name": "Boeing", "type": "Commercial" }, "date_of_birth": null, "date_of_death": null, "nationality": "Earthling", "twitter": null, "instagram": null, "bio": "Rosie the Astronaut is an Anthropomorphic Test Device (ATD), named after the iconic WWII character, Rosie the Riveter.\r\nIt will launch aboard the Boeing Starliner for its inaugural uncrewed flight to the International Space Station and back.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rosie2520the2520astronaut_image_20191204080725.jpg", "wiki": null, "last_flight": "2022-05-19T22:54:47Z", "first_flight": "2019-12-20T11:36:43Z" } } ], "spacecraft": { "id": 288, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/288/?format=api", "name": "Starliner Calypso", "serial_number": "3", "is_placeholder": false, "in_space": false, "time_in_space": "P95DT14H31M30S", "time_docked": "P92DT4H30M", "flights_count": 2, "mission_ends_count": 2, "status": { "id": 1, "name": "Active" }, "description": "The first CST-100 Starliner capsule to fly.", "spacecraft_config": { "id": 9, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/9/?format=api", "name": "CST-100 Starliner", "type": { "id": 2, "name": "Capsule" }, "agency": { "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", "parent": null, "image_url": null, "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/boeing_logo_20201128183345.png" }, "in_use": true, "capability": "Cargo and Human Transportation", "history": "The design draws upon Boeing's experience with NASA's Apollo, Space Shuttle and ISS programs as well as the Orbital Express project sponsored by the Department of Defense. A variety of validation tests have been underway on test articles since 2011.\r\n\r\nThe uncrewed orbital flight test launched on December 20, 2019, but after deployment, an 11-hour offset in the mission clock of Starliner caused the spacecraft to do a large engine burn, consumeing to much fuel, to reach the International Space Station, leading to an early return.\r\n\r\nA second uncrewed orbital flight test launched on May 19, 2022, which successfully reached the International Space Station.", "details": "The Boeing CST-100 Starliner (Crew Space Transportation) crew capsule is a spacecraft design under construction by Boeing as their entry for NASA's Commercial Crew Development program. Its primary purpose is to transport crew to the International Space Station and to private space stations. It is launched on United Launch Alliance Atlas V Rocket.", "maiden_flight": "2019-08-17", "height": 5.03, "diameter": 4.56, "human_rated": true, "crew_capacity": 7, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "210 days docked, 60 hours free flight.", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/boeing_starline_image_20220525180700.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Boeing_CST-100_Starliner", "info_link": "http://www.boeing.com/space/starliner/" } }, "landing": { "id": 1048, "attempt": true, "success": true, "description": "The Starliner spacecraft successfully landed at White Sands Missile Range.", "downrange_distance": null, "location": { "id": 20, "name": "White Sands Missile Range", "abbrev": "WSMR", "description": "US Army testing area and firing range located in the US state of New Mexico.", "location": { "id": 155, "url": "https://ll.thespacedevs.com/2.2.0/location/155/?format=api", "name": "White Sands Missile Range", "country_code": "USA", "description": "White Sands Missile Range is a United States Army military testing area and firing range located in the US state of New Mexico. The range was originally established in 1941 as the Alamogordo Bombing and Gunnery Range, where the Trinity test site lay at the northern end of the Range, in Socorro County near the towns of Carrizozo and San Antonio. It then became the White Sands Proving Ground on 9 July 1945.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_white_sands_missile_range_20210901072636.jpg", "timezone_name": "America/Denver", "total_launch_count": 5, "total_landing_count": 0 }, "successful_landings": 5 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [] } }, "mission": { "id": 1050, "name": "CST-100 Starliner Orbital Flight Test", "description": "This is the first test flight of Starliner spacecraft to the International Space Station. Although Atlas V and Centaur upper stage successfully put Starliner into planned trajectory, the spacecraft was unable to perform a nominal orbital insertion. Preliminary analysis indicate that Mission Elapsed Time (MET) system error led to Starliner burning more fuel than expected. Spacecraft is healthy and in stable orbit, but won't be able to reach and dock with ISS. Landing at White Sands Facility is planned on Dec 22.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/pad/29/?format=api", "agency_id": null, "name": "Space Launch Complex 41", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_41", "map_url": "https://www.google.com/maps?q=28.58341025,-80.58303644", "latitude": "28.58341025", "longitude": "-80.58303644", "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": 1013, "total_landing_count": 62 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_29_20200803143528.jpg", "total_launch_count": 114, "orbital_launch_attempt_count": 114 }, "infoURLs": [ { "priority": 0, "source": null, "title": "Atlas V Starliner - United Launch Alliance (ULA) Rocket Launch", "description": "A ULA Atlas V rocket will deliver the CST-100 Starliner spacecraft to a sub-orbital trajectory on its Orbital Flight Test (OFT) to the ISS.", "feature_image": null, "url": "https://www.ulalaunch.com/missions/atlas-v-oft", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Boeing's Starliner Launch to the International Space Station", "description": "Boeing’s Starliner spacecraft launched aboard an Atlas V rocket on an Orbital Flight Test at 6:36 a.m. EST, Friday, Dec. 20, 2019. The spacecraft had an off-...", "feature_image": "https://i.ytimg.com/vi/PIDytLL734A/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=PIDytLL734A", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "See Starliner launch to the International Space Station on Atlas V", "description": "Starliner, we are go for launch! Watch the CST-100 #Starliner launch on its Orbital Flight Test lifted by the United Launch Alliance #AtlasV to the Internati...", "feature_image": "https://i.ytimg.com/vi/k6ZroPZojyc/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=k6ZroPZojyc", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Atlas V Starliner OFT Launch Highlights", "description": "A United Launch Alliance (ULA) Atlas V rocket carrying Boeing's Starliner lifts off from Space Launch Complex-41 at 6:36 a.m. ET on Dec. 20, 2019.", "feature_image": "https://i.ytimg.com/vi/FWDotD85Nqo/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=FWDotD85Nqo", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas_v_n22_image_20210813082339.jpeg", "infographic": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/infographic_images/atlas2520v252_infographic_20200806040128.png", "program": [ { "id": 5, "url": "https://ll.thespacedevs.com/2.2.0/program/5/?format=api", "name": "Commercial Crew Program", "description": "The Commercial Crew Program (CCP) is a human spaceflight program operated by NASA, in association with American aerospace manufacturers Boeing and SpaceX. The program conducts rotations between the expeditions of the International Space Station program, transporting crews to and from the International Space Station (ISS) aboard Boeing Starliner and SpaceX Crew Dragon capsules, in the first crewed orbital spaceflights operated by private companies.", "agencies": [ { "id": 80, "url": "https://ll.thespacedevs.com/2.2.0/agencies/80/?format=api", "name": "Boeing", "type": "Commercial" }, { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 121, "url": "https://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/commercial2520_program_20200820201209.png", "start_date": "2011-04-18T00:00:00Z", "end_date": null, "info_url": "https://www.nasa.gov/exploration/commercial/crew/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Commercial_Crew_Program", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 5919, "location_launch_attempt_count": 791, "pad_launch_attempt_count": 94, "agency_launch_attempt_count": 137, "orbital_launch_attempt_count_year": 99, "location_launch_attempt_count_year": 13, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P134DT1H23M43S", "mission_patches": [ { "id": 164, "name": "CST-100 Starliner Orbital Flight Test Patch", "priority": 9, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/cst-1002520sta_mission_patch_20211031042602.png", "agency": { "id": 80, "url": "https://ll.thespacedevs.com/2.2.0/agencies/80/?format=api", "name": "Boeing", "type": "Commercial" } } ], "type": "detailed" }
