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/a5e056e5-1e07-4479-9352-bd18cd7eecf7/?format=api
{ "id": "a5e056e5-1e07-4479-9352-bd18cd7eecf7", "url": "https://ll.thespacedevs.com/2.2.0/launch/a5e056e5-1e07-4479-9352-bd18cd7eecf7/?format=api", "slug": "ariane-6-2-x-galileo-second-generation-g2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ariane 6 | 2 x Galileo Second Generation (G2)", "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2025-01-30T09:57:41Z", "updates": [ { "id": 9960, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch", "info_url": "https://europeanspaceflight.com/arianespace-secures-three-ariane-6-launch-deals-in-two-days/", "created_by": "Nosu", "created_on": "2025-01-30T09:57:00Z" } ], "net": "2029-12-31T00:00:00Z", "net_precision": { "id": 16, "name": "Decade", "abbrev": "DEC", "description": "The T-0 is expected in the given decade." }, "window_end": "2029-12-31T00:00:00Z", "window_start": "2029-12-31T00:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "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": 319, "consecutive_successful_launches": 7, "successful_launches": 304, "failed_launches": 15, "pending_launches": 48, "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": 8509, "configuration": { "id": 506, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/506/?format=api", "name": "Ariane 6", "active": true, "reusable": false, "description": "Ariane 6 (unknown variant)", "family": "Ariane", "full_name": "Ariane 6", "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": "N/A", "alias": "", "min_stage": 2, "max_stage": 2, "length": 63.0, "diameter": 5.4, "maiden_flight": null, "launch_cost": null, "launch_mass": null, "leo_capacity": 21650, "gto_capacity": 11500, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_6_image_20240125142128.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Ariane_6", "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7099, "name": "2 x Galileo Second Generation (G2)", "description": "Payload consists of two satellites for Europe's second generation Galileo navigation system.", "launch_designator": null, "type": "Navigation", "orbit": { "id": 12, "name": "Medium Earth Orbit", "abbrev": "MEO" }, "agencies": [ { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/agencies/27/?format=api", "name": "European Space Agency", "featured": false, "type": "Multinational", "country_code": "FRA,ITA,DEU,ESP,CHE,GBR,AUT,SWE,PRT,NLD,HUN,POL,DNK,CZE,ROU,NOR,FIN,GRC,EST,IRL,LUX,BEL,SVN", "abbrev": "ESA", "description": "The European Space Agency is an intergovernmental organisation of 22 member states. Established in 1975 and headquartered in Paris, France, ESA has a worldwide staff of about 2,000 employees.\r\n\r\nESA's space flight programme includes human spaceflight (mainly through participation in the International Space Station program); the launch and operation of unmanned exploration missions to other planets and the Moon; Earth observation, science and telecommunication; designing launch vehicles; and maintaining a major spaceport, the Guiana Space Centre at Kourou, French Guiana.", "administrator": "Director General: Josef Aschbacher", "founding_year": "1975", "launchers": "Ariane | Vega", "spacecraft": "Space Rider", "launch_library_url": null, "total_launch_count": 7, "consecutive_successful_launches": 5, "successful_launches": 6, "failed_launches": 1, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.esa.int/", "wiki_url": "http://en.wikipedia.org/wiki/European_Space_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/esa_patch_float_image_20250211192109.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/european2520space2520agency_logo_20221130101442.png" }, { "id": 1043, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1043/?format=api", "name": "European Union Agency for the Space Programme", "featured": false, "type": "Multinational", "country_code": "AUT,BEL,BGR,HRV,CYP,CZE,DNK,EST,FIN,FRA,DEU,GRC,HUN,IRL,ITA,LVA,LTU,LUX,MLT,NLD,POL,PRT,ROU,SVK,SVN,ESP,SWE", "abbrev": "EUSPA", "description": "The European Union Agency for the Space Programme (EUSPA) is a space agency, managing the European Union Space Programme as one of the agencies of the European Union (EU). It was initially created as the European Global Navigation Satellite Systems Supervisory Authority (GSA) in 2004, reorganised into the European Global Navigation Satellite Systems Agency (also GSA) in 2010, and established in its current form on May 12, 2021. EUSPA is a separate entity from the European Space Agency (ESA), although the two entities work together closely.", "administrator": "Executive Director: Rodrigo da Costa", "founding_year": "2021", "launchers": "", "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.euspa.europa.eu/", "wiki_url": "https://en.wikipedia.org/wiki/European_Union_Agency_for_the_Space_Programme", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/european2520union2520agency2520for2520the2520space2520programme_logo_20221129162709.png", "image_url": null, "nation_url": null } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 67, "url": "https://ll.thespacedevs.com/2.2.0/pad/67/?format=api", "agency_id": 115, "name": "Ariane Launch Area 4", "description": "ELA-4, is a launch pad and associated facilities at the Centre Spatial Guyanais in French Guiana. The complex is composed of a launch pad with mobile gantry, an horizontal assembly building and a dedicated launch operations building. ELA-4 is operated by Arianespace as part of the Ariane 6 program.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Guiana_Space_Centre", "map_url": "https://www.google.com/maps?q=5.256319,-52.786838", "latitude": "5.256319", "longitude": "-52.786838", "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": 325, "total_landing_count": 0 }, "country_code": "GUF", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_67_20200803143559.jpg", "total_launch_count": 2, "orbital_launch_attempt_count": 2 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_6_image_20240125142128.jpeg", "infographic": null, "program": [ { "id": 30, "url": "https://ll.thespacedevs.com/2.2.0/program/30/?format=api", "name": "Galileo", "description": "Galileo is a global navigation satellite system (GNSS) that went live in 2016, created by the European Union through the European Space Agency (ESA), operated by the European Union Agency for the Space Programme (EUSPA).", "agencies": [ { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/agencies/27/?format=api", "name": "European Space Agency", "type": "Multinational" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galileo_program_20231230110547.png", "start_date": "2011-10-21T10:30:00Z", "end_date": null, "info_url": "https://www.gsc-europa.eu/", "wiki_url": "https://en.wikipedia.org/wiki/Galileo_(satellite_navigation)", "mission_patches": [], "type": { "id": 4, "name": "Navigation Constellation" } } ], "orbital_launch_attempt_count": 7278, "location_launch_attempt_count": 366, "pad_launch_attempt_count": 20, "agency_launch_attempt_count": 356, "orbital_launch_attempt_count_year": 16, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "pad_turnaround": "P731D", "mission_patches": [], "type": "detailed" }
