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/fc71e640-7cf6-4a00-b526-fc42156d46cf/?format=api
{ "id": "fc71e640-7cf6-4a00-b526-fc42156d46cf", "url": "https://ll.thespacedevs.com/2.2.0/launch/fc71e640-7cf6-4a00-b526-fc42156d46cf/?format=api", "slug": "ariane-5-es-edoardo-amaldi-atv-atv-003", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ariane 5 ES | Edoardo Amaldi ATV (ATV-003)", "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-14T04:01:22Z", "updates": [], "net": "2012-03-23T04:34:05Z", "net_precision": null, "window_end": "2012-03-23T04:34:05Z", "window_start": "2012-03-23T04:34:05Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": null, "hashtag": null, "launch_service_provider": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "featured": true, "type": "Commercial", "country_code": "FRA", "abbrev": "ASA", "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.", "administrator": "CEO: David Cavaillolès", "founding_year": "1980", "launchers": "Ariane | Vega", "spacecraft": "", "launch_library_url": null, "total_launch_count": 318, "consecutive_successful_launches": 6, "successful_launches": 303, "failed_launches": 15, "pending_launches": 49, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.arianespace.com", "wiki_url": "http://en.wikipedia.org/wiki/Arianespace", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg" }, "rocket": { "id": 789, "configuration": { "id": 18, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/18/?format=api", "name": "Ariane 5 ES", "active": false, "reusable": false, "description": "The Ariane 5 ES (Evolution Storable) has an estimated LEO launch capacity of 21,000 kg (46,000 lb). It includes all the performance improvements of Ariane 5 ECA core and boosters but replaces the ESC-A second stage with the restartable EPS used on Ariane 5 GS variants. It was used to launch the Automated Transfer Vehicle (ATV) into a 260 km circular low Earth orbit inclined at 51.6° and has been used 3 times to launch 4 Galileo navigation satellites at a time directly into their operational orbit. The Ariane 5 ES flew 8 times from 2008 to 2018 with no failures.", "family": "Ariane", "full_name": "Ariane 5 ES", "manufacturer": { "id": 1044, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1044/?format=api", "name": "ArianeGroup", "featured": false, "type": "Commercial", "country_code": "FRA", "abbrev": "AG", "description": "ArianeGroup (formerly Airbus Safran Launchers) is an aerospace company based in France. A joint venture between Airbus and Safran, the company was founded in 2015 and is headquartered in Issy-les-Moulineaux. It consists of three core arms: aerospace, defence and security.", "administrator": "CEO: Martin Sion", "founding_year": "2015", "launchers": "Ariane", "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": "https://www.ariane.group/", "wiki_url": "https://en.wikipedia.org/wiki/ArianeGroup", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianegroup_logo_20221130111224.PNG", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianegroup_nation_20230802053255.jpg" }, "program": [], "variant": "ES", "alias": "", "min_stage": 0, "max_stage": 2, "length": 45.7, "diameter": 5.4, "maiden_flight": "2008-03-09", "launch_cost": null, "launch_mass": 746, "leo_capacity": 21000, "gto_capacity": null, "to_thrust": 11400, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane252052520es_image_20190222031145.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Ariane_5", "total_launch_count": 8, "consecutive_successful_launches": 8, "successful_launches": 8, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 262, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/262/?format=api", "mission_end": "2012-10-03T00:00:00Z", "destination": "International Space Station", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 157, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/157/?format=api", "name": "Edoardo Amaldi ATV", "serial_number": "ATV-003", "is_placeholder": false, "in_space": false, "time_in_space": "P193DT19H25M55S", "time_docked": "P183DT22H53M", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "The Edoardo Amaldi ATV, or Automated Transfer Vehicle 003 (ATV-003), was a European unmanned cargo resupply spacecraft, named after the 20th-century Italian physicist Edoardo Amaldi. The spacecraft was launched by the European Space Agency (ESA) on 23 March 2012, on a mission to supply the International Space Station (ISS) with propellant, water, oxygen, and dry cargo.", "spacecraft_config": { "id": 17, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/17/?format=api", "name": "Automated Transfer Vehicle (ATV)", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "featured": true, "type": "Commercial", "country_code": "FRA", "abbrev": "ASA", "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.", "administrator": "CEO: David Cavaillolès", "founding_year": "1980", "launchers": "Ariane | Vega", "spacecraft": "", "parent": "ArianeGroup", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png" }, "in_use": false, "capability": "Cargo Earth Orbit Logistics", "history": "During the 1990s, as the International Space Station program was taking place, it was collectively recognised by the 15 participating nations that, upon completion, the International Space Station (ISS), a crewed space station in Low Earth orbit (LEO), would require regular resupply missions in order to meet the needs of the onboard crew as well as to deliver apparatus to support the various scientific tests that would be performed on board. In October 1995, it was agreed that, amongst the various contributions to the ISS program that Europe would assume responsibility for under the vestiges of the European Space Agency (ESA), would be the Automated Transfer Vehicle, or ATV; this logistics-orientated spacecraft would perform the identified resupply missions to ISS.", "details": "In terms of its role, the ATV was designed to complement the smaller Russian Progress spacecraft, possessing three times its useful payload capacity. Similar to the Progress, it would carry both bulk liquids and relatively fragile freight, which would be stored within a cargo hold maintained at a pressurized shirt-sleeve environment in order that astronauts would be able to access payloads without the need to put on spacesuits. The pressurized cargo section of the ATV was based on the Italian-built Multi-Purpose Logistics Module (MPLM), which was a Shuttle-carried \"space barge\" that had been previously used for transporting equipment to and from the Station. Unlike the MPLM, the ATV used the same docking mechanism as employed upon the Progress. The ATV, like the Progress, also serves as a container for the station's waste. Each ATV weighs 20.7 tonnes at launch and has a cargo capacity of 8 tonnes.", "maiden_flight": "2008-03-09", "height": 10.3, "diameter": 4.5, "human_rated": false, "crew_capacity": null, "payload_capacity": 7667, "payload_return_capacity": null, "flight_life": "Six months when docked", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/automated_trans_image_20231118111716.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Automated_Transfer_Vehicle", "info_link": "" } }, "landing": { "id": 451, "attempt": false, "success": null, "description": "The ATV 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": 152, "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": "2012-03-28T22:51:00Z", "departure": "2012-09-28T21:44:00Z", "docking_location": { "id": 2, "name": "Zvezda aft", "spacestation": { "id": 4, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/4/?format=api", "name": "International Space Station" } } } ] } }, "mission": { "id": 638, "name": "Edoardo Amaldi ATV (ATV-003)", "description": "ATV-3 is the Automated Transfer Vehicle operated by the European Space Agency (ESA) to resupply the international space station (ISS) with propellant, water, air and dry cargo. After 5 days in orbit it docked to the ISS on 23rd March 2012.", "launch_designator": null, "type": "Resupply", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 77, "url": "https://ll.thespacedevs.com/2.2.0/pad/77/?format=api", "agency_id": 115, "name": "Ariane Launch Area 3", "description": "ELA-3, is a launch pad and associated facilities at the Centre Spatial Guyanais in French Guiana. ELA-3 was operated by Arianespace as part of the expendable launch system for Ariane 5 launch vehicles.", "info_url": null, "wiki_url": "http://en.wikipedia.org/wiki/ELA-3", "map_url": "https://www.google.com/maps?q=5.239,-52.768", "latitude": "5.239", "longitude": "-52.768", "location": { "id": 13, "url": "https://ll.thespacedevs.com/2.2.0/location/13/?format=api", "name": "Guiana Space Centre, French Guiana", "country_code": "GUF", "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "timezone_name": "America/Cayenne", "total_launch_count": 324, "total_landing_count": 0 }, "country_code": "GUF", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_77_20200803143458.jpg", "total_launch_count": 118, "orbital_launch_attempt_count": 118 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Replay of the ATV-3 launch", "description": "ESA's third Automated Transfer Vehicle, Edoardo Amald, has been launched from Europe's Spaceport in Kourou, French Guiana, with a night-time liftoff at 05:34...", "feature_image": "https://i.ytimg.com/vi/FHMGfZy6FQg/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=FHMGfZy6FQg", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane252052520es_image_20190222031145.jpeg", "infographic": null, "program": [ { "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": 5200, "location_launch_attempt_count": 217, "pad_launch_attempt_count": 61, "agency_launch_attempt_count": 202, "orbital_launch_attempt_count_year": 10, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P183DT6H56M5S", "mission_patches": [], "type": "detailed" }
