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/5ff7d8c6-9fc0-439c-ad10-9e6ce2d1e86d/?format=api
{ "id": "5ff7d8c6-9fc0-439c-ad10-9e6ce2d1e86d", "url": "https://ll.thespacedevs.com/2.2.0/launch/5ff7d8c6-9fc0-439c-ad10-9e6ce2d1e86d/?format=api", "slug": "atlas-v-401-cygnus-crs-oa-7-ss-john-glenn", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas V 401 | Cygnus CRS OA-7 (S.S. John Glenn)", "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:34Z", "updates": [], "net": "2017-04-18T15:11:26Z", "net_precision": null, "window_end": "2017-04-18T15:41:00Z", "window_start": "2017-04-18T15:11:00Z", "probability": 90, "weather_concerns": null, "holdreason": "", "failreason": null, "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": 45, "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": 1995, "configuration": { "id": 16, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/16/?format=api", "name": "Atlas V 401", "active": true, "reusable": false, "description": "An Atlas V with a 4 meter diameter fairing, no boosters and a single centaur upper stage engine.", "family": "Atlas", "full_name": "Atlas V 401", "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": 45, "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": "401", "alias": "", "min_stage": 2, "max_stage": 2, "length": 58.3, "diameter": 3.8, "maiden_flight": "2002-08-21", "launch_cost": "115000000", "launch_mass": 590, "leo_capacity": 9050, "gto_capacity": 4950, "to_thrust": 3827, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/atlas_v_image_20201212013334.jpeg", "info_url": "https://www.ulalaunch.com/rockets/atlas-v", "wiki_url": "https://en.wikipedia.org/wiki/Atlas_V", "total_launch_count": 41, "consecutive_successful_launches": 41, "successful_launches": 41, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 291, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/291/?format=api", "mission_end": "2017-06-11T17:08:00Z", "destination": "International Space Station", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 167, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/167/?format=api", "name": "Cygnus CRS OA-7", "serial_number": null, "is_placeholder": false, "in_space": false, "time_in_space": "P54DT1H56M34S", "time_docked": "P43DT1H", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Cygnus CRS OA-7, also known as Orbital ATK CRS-7, is the eighth flight of the Orbital ATK unmanned resupply spacecraft Cygnus and its seventh flight to the International Space Station under the Commercial Resupply Services contract with NASA. Orbital and NASA jointly developed a new space transportation system to provide commercial cargo resupply services to the International Space Station (ISS). Under the Commercial Orbital Transportation Services (COTS) program, then Orbital Sciences designed and built Antares, a medium-class launch vehicle; Cygnus, an advanced maneuvering spacecraft, and a Pressurized Cargo Module which is provided by Orbital's industrial partner Thales Alenia Space.\r\n\r\nThe OA-7 is named the S.S. John Glenn in honor of astronaut and senator John Glenn, the first US astronaut to orbit the Earth on Mercury 6 and the oldest to go to space on STS-95.", "spacecraft_config": { "id": 19, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/19/?format=api", "name": "Cygnus Enhanced", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "id": 257, "url": "https://ll.thespacedevs.com/2.2.0/agencies/257/?format=api", "name": "Northrop Grumman Space Systems", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "NGSS", "description": "Northrup Grumman Space Systems designs, builds and delivers space, defence and aviation-related systems to customers around the world. They aquired Orbital ATK in 2018 along with its launchers and ongoing missions.", "administrator": "CEO: Kathy Warden", "founding_year": "2015", "launchers": "Antares | Minotaur | Pegasus", "spacecraft": "Cygnus", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/northrop2520grumman2520innovation2520systems_image_20190207032451.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/northrop2520grumman2520innovation2520systems_logo_20190207032451.png" }, "in_use": true, "capability": "Cargo Earth Orbit Logistics", "history": "Cygnus is a spacecraft developed originally by Orbital ATK and then acquired by Northrup Grumman after an acquisition. It is used to transport cargo to the ISS.\r\n\r\nThe first operational mission of Cygnus to the ISS was in September 2013.\r\n\r\nOne flight on 28 October 2014 ended in a failure when the Antares launch vehicle, used to launch the Cygnus, exploded shortly after launch. This set back the Cygnus launch schedule over a year. Following the launch anomaly a new version known as 'Cygnus Enhanced' was flown. This extended the Cygnus length and allowed it to carry an extra 700kg to the ISS.", "details": "The Cygnus spacecraft is launched aboard Antares, Atlas V, or Falcon 9 to deliver cargo to the ISS under NASAs CRS contracts. It has no heatshield so at the end of its mission its used to dispose of waste by burning up in the Earths atmosphere.", "maiden_flight": "2015-12-06", "height": 6.3, "diameter": 3.07, "human_rated": false, "crew_capacity": null, "payload_capacity": 3750, "payload_return_capacity": null, "flight_life": "1 week to 2 years design life.", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cygnus2520enhanced_image_20190207032513.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Cygnus_(spacecraft)", "info_link": "" } }, "landing": { "id": 420, "attempt": false, "success": null, "description": "The Cygnus spacecraft burned up as planned upon entering Earth's atmosphere.", "downrange_distance": null, "location": null, "type": { "id": 7, "name": "Destructive Reentry", "abbrev": "ATM", "description": "Spacecraft burned up in the atmosphere" } }, "docking_events": [ { "id": 177, "spacestation": { "id": 4, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/4/?format=api", "name": "International Space Station", "status": { "id": 1, "name": "Active" }, "founded": "1998-11-20", "description": "The International Space Station (ISS) is a space station, or a habitable artificial satellite, in low Earth orbit. Its first component was launched into orbit in 1998, with the first long-term residents arriving in November 2000. It has been inhabited continuously since that date. The last pressurised module was fitted in 2011, and an experimental inflatable space habitat was added in 2016. The station is expected to operate until 2030. Development and assembly of the station continues, with several new elements scheduled for launch in 2019. The ISS is the largest human-made body in low Earth orbit and can often be seen with the naked eye from Earth. The ISS consists of pressurised habitation modules, structural trusses, solar arrays, radiators, docking ports, experiment bays and robotic arms. ISS components have been launched by Russian Proton and Soyuz rockets, and American Space Shuttles.", "orbit": "Low Earth Orbit", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/international2520space2520station_image_20190220215716.jpeg" }, "docking": "2017-04-22T10:05:00Z", "departure": "2017-06-04T11:05:00Z", "docking_location": { "id": 1, "name": "Unity nadir", "spacestation": { "id": 4, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/4/?format=api", "name": "International Space Station" } } } ] } }, "mission": { "id": 113, "name": "Cygnus CRS OA-7 (S.S. John Glenn)", "description": "This is the eighth planned flight of the Orbital ATK's unmanned resupply spacecraft Cygnus and its seventh flight to the International Space Station under the Commercial Resupply Services contract with NASA. Orbital ATK named the vehicle after astronaut John Glenn, the first American to orbit Earth and pioneer of human spaceflight.", "launch_designator": null, "type": "Resupply", "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": 1015, "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": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Rocket Launch 360: Atlas V OA-7", "description": "Watch as ULA's Atlas V rocket blasts off -- in 360 -- with the OA-7 mission for Orbital ATk and NASA from a lightning tower at Space Launch COmplex-41. The m...", "feature_image": "https://i.ytimg.com/vi/QOXASRS0ubw/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=QOXASRS0ubw", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Atlas V OA-7 Launch Highlights", "description": "A United Launch Alliance (ULA) Atlas V rocket lifts off with the OA-7 resupply spacecraft to the International Space Station. The OA-7 mission represents the...", "feature_image": "https://i.ytimg.com/vi/BMFwLqIzhcA/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=BMFwLqIzhcA", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Atlas V OA-7 Rocket Cam", "description": "Get YouTube without the ads", "feature_image": "https://i.ytimg.com/vi/c5wWW0hw-gA/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=c5wWW0hw-gA", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Orbital ATK’s Cygnus Cargo Spacecraft Launches to the ISS", "description": "On April 18, Orbital ATK’s Cygnus cargo space craft launched from Cape Canaveral Air Force Station in Florida aboard a United Launch Alliance rocket, on Orbi...", "feature_image": "https://i.ytimg.com/vi/7I78wLrWBmA/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=7I78wLrWBmA", "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_image_20201212013334.jpeg", "infographic": null, "program": [ { "id": 11, "url": "https://ll.thespacedevs.com/2.2.0/program/11/?format=api", "name": "Commercial Resupply Services", "description": "Commercial Resupply Services (CRS) are a series of flights awarded by NASA for the delivery of cargo and supplies to the International Space Station.The first CRS contracts were signed in 2008 and awarded $1.6 billion to SpaceX for twelve cargo Dragon and $1.9 billion to Orbital Sciences for eight Cygnus flights, covering deliveries to 2016. The Falcon 9 and Antares rockets were also developed under the CRS program to deliver cargo spacecraft to the ISS.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 257, "url": "https://ll.thespacedevs.com/2.2.0/agencies/257/?format=api", "name": "Northrop Grumman Space Systems", "type": "Commercial" }, { "id": 1020, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1020/?format=api", "name": "Sierra Nevada Corporation", "type": "Commercial" }, { "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_20201129212219.png", "start_date": "2008-12-23T00:00:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Commercial_Resupply_Services#Commercial_Resupply_Services", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } }, { "id": 17, "url": "https://ll.thespacedevs.com/2.2.0/program/17/?format=api", "name": "International Space Station", "description": "The International Space Station programme is tied together by a complex set of legal, political and financial agreements between the sixteen nations involved in the project, governing ownership of the various components, rights to crewing and utilization, and responsibilities for crew rotation and resupply of the International Space Station. It was conceived in 1984 by President Ronald Reagan, during the Space Station Freedom project as it was originally called.", "agencies": [ { "id": 16, "url": "https://ll.thespacedevs.com/2.2.0/agencies/16/?format=api", "name": "Canadian Space Agency", "type": "Government" }, { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/agencies/27/?format=api", "name": "European Space Agency", "type": "Multinational" }, { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "type": "Government" }, { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/international2_program_20201129184745.png", "start_date": "1998-11-20T06:40:00Z", "end_date": null, "info_url": "https://www.nasa.gov/mission_pages/station/main/index.html", "wiki_url": "https://en.wikipedia.org/wiki/International_Space_Station_programme", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 5635, "location_launch_attempt_count": 757, "pad_launch_attempt_count": 86, "agency_launch_attempt_count": 120, "orbital_launch_attempt_count_year": 20, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P87DT14H29M26S", "mission_patches": [], "type": "detailed" }
