Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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'
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.0.0/launch/7651a3ee-a5d8-4e2d-a526-28a4c3b02b56/?format=api
{ "id": "7651a3ee-a5d8-4e2d-a526-28a4c3b02b56", "url": "https://lldev.thespacedevs.com/2.0.0/launch/7651a3ee-a5d8-4e2d-a526-28a4c3b02b56/?format=api", "launch_library_id": 1434, "slug": "ariane-5-eca-saudi-geostationary-satellite-1hellas", "name": "Ariane 5 ECA | Saudi Geostationary Satellite 1/Hellas Sat 4 & GSAT-31", "status": { "id": 3, "name": "Success" }, "net": "2019-02-05T21:01:07Z", "window_end": "2019-02-05T21:01:07Z", "window_start": "2019-02-05T21:01:07Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 115, "url": "https://lldev.thespacedevs.com/2.0.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": 328, "consecutive_successful_launches": 16, "successful_launches": 313, "failed_launches": 15, "pending_launches": 51, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.arianespace.com", "wiki_url": "https://en.wikipedia.org/wiki/Arianespace", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ariane_64_lifto_image_20260213070745.jpg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg" }, "rocket": { "id": 23, "configuration": { "id": 20, "launch_library_id": 27, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/20/?format=api", "name": "Ariane 5 ECA", "description": "Ariane 5 is a heavy-lift launch vehicle, part of the Ariane rocket family.", "family": "Ariane", "full_name": "Ariane 5 ECA", "manufacturer": { "id": 1044, "url": "https://lldev.thespacedevs.com/2.0.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: Christophe Bruneau", "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-dev.nyc3.digitaloceanspaces.com/media/images/arianegroup_logo_20221130111224.PNG", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ariane_62_on_el_image_20240708201807.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/arianegroup_nation_20230802053255.jpg" }, "program": [], "variant": "ECA", "alias": "", "min_stage": 0, "max_stage": 2, "length": 57.7, "diameter": 5.4, "maiden_flight": "2002-12-11", "launch_mass": 780, "leo_capacity": null, "gto_capacity": 10500, "to_thrust": 11400, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ariane252052520eca_image_20190224012333.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Ariane_5", "total_launch_count": 73, "consecutive_successful_launches": 8, "successful_launches": 71, "failed_launches": 2, "pending_launches": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 853, "launch_library_id": 895, "name": "Saudi Geostationary Satellite 1/Hellas Sat 4 & GSAT-31", "description": "Hellas Sat 4/SaudiGeoSat 1 is a geostationary communications satellite to be used jointly by Hellas Sat and KACST. It will provide advanced telecommunications capabilities, including television, internet, telephone and secure military communications to customers in the Middle East, Africa and Europe. Another passenger of the launch is an Indian communications satellite GSAT-31.", "launch_designator": null, "type": "Communications", "orbit": { "id": 2, "name": "Geostationary Transfer Orbit", "abbrev": "GTO" } }, "pad": { "id": 77, "url": "https://lldev.thespacedevs.com/2.0.0/pad/77/?format=api", "agency_id": 115, "name": "Ariane Launch Area 3", "info_url": null, "wiki_url": "https://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://lldev.thespacedevs.com/2.0.0/location/13/?format=api", "name": "Guiana Space Centre, French Guiana", "country_code": "GUF", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "total_launch_count": 336, "total_landing_count": 0 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_77_20200803143458.jpg", "total_launch_count": 118 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "title": "[Live] Ariane 5 launch VA247", "description": "Ariane 5 orbiting two telecommunications satellites from the Guiana Space Center in Kourou : Saudi Geostationary Satellite 1/Hellas Sat 4 and GSat-31 on February 5, 2019. Liftoff at 22:01 (Paris time)...", "feature_image": "https://i.ytimg.com/vi/gotxGt_luQ8/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=gotxGt_luQ8" }, { "priority": 0, "title": "VA247 - Décollage d'Ariane 5 le 05/02/2019", "description": "Ralentis du décollage de la 1ere Ariane 5 de 2019. A son bord, deux satellites de télécommunication, HS4/SGS-1 et GSAT-31 : le premier pour des clients Saoudiens, Grecs et Chypriotes, le second pour l...", "feature_image": "https://i.ytimg.com/vi/YEaZhGIhfzg/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=YEaZhGIhfzg" }, { "priority": 0, "title": "[Direct] Décollage d'Ariane 5 VA247", "description": "Mise en orbite des satellites de télécommunications Saudi Geostationary Satellite 1/Hellas Sat 4 et GSat-31 le 05/02/19 par la fusée Ariane 5 ECA depuis le Centre spatial guyanais. Décollage à 22h01 (...", "feature_image": "https://i.ytimg.com/vi/fcYBP1sl7Zo/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=fcYBP1sl7Zo" } ], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ariane252052520eca_image_20190224012333.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5829, "location_launch_attempt_count": 289, "pad_launch_attempt_count": 104, "agency_launch_attempt_count": 274, "orbital_launch_attempt_count_year": 9, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1 }