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/8225eb20-e71c-44fd-bcbe-868c29ca299f/?format=api
{ "id": "8225eb20-e71c-44fd-bcbe-868c29ca299f", "url": "https://ll.thespacedevs.com/2.2.0/launch/8225eb20-e71c-44fd-bcbe-868c29ca299f/?format=api", "slug": "atlas-v-401-cygnus-crs-orb-4-ss-deke-slayton-ii", "flightclub_url": null, "r_spacex_api_id": null, "name": "Atlas V 401 | Cygnus CRS Orb-4 (S.S. Deke Slayton II)", "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:33Z", "updates": [], "net": "2015-12-06T21:44:57Z", "net_precision": null, "window_end": "2015-12-06T22:14:56Z", "window_start": "2015-12-06T21:44:57Z", "probability": -1, "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": 1888, "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": 288, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/288/?format=api", "mission_end": "2016-02-20T16:00:00Z", "destination": "International Space Station", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 164, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/164/?format=api", "name": "Cygnus CRS OA-4", "serial_number": null, "is_placeholder": false, "in_space": false, "time_in_space": "P75DT18H15M3S", "time_docked": "P71DT23H19M", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Cygnus CRS OA-4, also known as Orbital ATK CRS-4 and CRS Orb-4, was the fourth successful flight of the Orbital ATK uncrewed resupply spacecraft Cygnus and its third flight to the International Space Station under the Commercial Resupply Services contract with NASA. With the Antares rocket undergoing a redesign following its failure during the Orb-3 launch, OA-4 was launched by an Atlas V rocket. Following three launch delays due to inclement weather beginning on 3 December 2015, OA-4 was launched at 21:44 UTC on 6 December 2015. With a liftoff weight of 7,492 kilograms, OA-4 became the heaviest payload ever launched on an Atlas V. The spacecraft rendezvoused with and was berthed to the ISS on 9 December 2015. It was released on 19 February 2016 after 72 days at the station. Deorbit occurred on 20 February at approximately 16:00 UTC.", "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": 417, "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": 174, "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": "2015-12-09T11:19:00Z", "departure": "2016-02-19T10:38: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": 79, "name": "Cygnus CRS Orb-4 (S.S. Deke Slayton II)", "description": "This is the 4th mission under NASA's Commercial Resupply Service agreement with Orbital ATK. The unmanned Cygnus cargo vessel delievered approximately 3,500 kg (7,700 lbs.) of supplies and science experiments to the International Space Station. The craft features a longer, enhanced cargo module and remained berthed to the station for 2 months.", "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": 63 }, "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": "Atlas V OA-4 Launch Highlights", "description": "A United Launch Alliance (ULA) Atlas V rocket carrying the OA-4 mission lifts off from Space Launch Complex 41. The mission, flown for Orbital ATK under NASA...", "feature_image": "https://i.ytimg.com/vi/6o4pAQFULf8/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=6o4pAQFULf8", "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": 5518, "location_launch_attempt_count": 735, "pad_launch_attempt_count": 76, "agency_launch_attempt_count": 104, "orbital_launch_attempt_count_year": 76, "location_launch_attempt_count_year": 16, "pad_launch_attempt_count_year": 8, "agency_launch_attempt_count_year": 12, "pad_turnaround": "P36DT5H31M57S", "mission_patches": [ { "id": 151, "name": "Cygnus CRS Orb-4 (S.S. Deke Slayton II) Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/cygnus2520crs_mission_patch_20211031042554.png", "agency": { "id": 179, "url": "https://ll.thespacedevs.com/2.2.0/agencies/179/?format=api", "name": "Orbital ATK", "type": "Commercial" } } ], "type": "detailed" }
