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/ac492fe8-2ac6-488c-88c3-e5470687544f/?format=api
{ "id": "ac492fe8-2ac6-488c-88c3-e5470687544f", "url": "https://ll.thespacedevs.com/2.2.0/launch/ac492fe8-2ac6-488c-88c3-e5470687544f/?format=api", "slug": "ariane-5-eca-intelsat-37e-bsat-4a", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ariane 5 ECA | Intelsat 37e & BSAT-4a", "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:25Z", "updates": [], "net": "2017-09-29T21:56:00Z", "net_precision": null, "window_end": "2017-09-29T22:25:00Z", "window_start": "2017-09-29T21:47:00Z", "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": 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": 1267, "configuration": { "id": 20, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/20/?format=api", "name": "Ariane 5 ECA", "active": false, "reusable": false, "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://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": "ECA", "alias": "", "min_stage": 0, "max_stage": 2, "length": 57.7, "diameter": 5.4, "maiden_flight": "2002-12-11", "launch_cost": null, "launch_mass": 780, "leo_capacity": null, "gto_capacity": 10500, "to_thrust": 11400, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.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, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 906, "name": "Intelsat 37e & BSAT-4a", "description": "Intelsat 37e is a geostationary communications satellite for Intelsat, another one of the EpicNG series. It weighs about 6700 kg and is equipped with C-band, Ku-band and Ka-band transopnders. Intelsat 37e is a replacement for the Intelsat 901 spacecraft in the 18° W orbital slot, covering Europe, Africa, South America and North America. \nBSAT-4a is a geostationary communications satellite for the Japanese satellite operator B-SAT. Satellite is equipped with 24 Ku transponders and weighs about 3500 kg. It is to reside in 110° East orbital position, providing high-resolution direct television broadcasting to Japan.", "launch_designator": null, "type": "Communications", "orbit": { "id": 2, "name": "Geostationary Transfer Orbit", "abbrev": "GTO" }, "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": 325, "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": "VA239 - 09/29/2017", "description": "Arianespace orbited telecommunications satellites for long-time customers on today’s successful mission – confirming the company’s role as a launch services ...", "feature_image": "https://i.ytimg.com/vi/qn6XfKIwN-Q/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=qn6XfKIwN-Q", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Arianespace Vol VA239 / Intelsat 37e et BSAT-4a (VF)", "description": "VA239 : Intelsat 37e et BSAT-4a lancés par Arianespace : 81e succès d’affilée pour Ariane 5 Arianespace a lancé avec succès le satellite de télécommunication...", "feature_image": "https://i.ytimg.com/vi/C3fUtO43Umg/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=C3fUtO43Umg", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Ariane 5 orbits Intelsat 37e and BSAT-4a on Arianespace’s latest mission from the Spaceport", "description": "Arianespace orbited telecommunications satellites for long-time customers on today’s successful mission – confirming the company’s role as a launch services ...", "feature_image": "https://i.ytimg.com/vi/cF1KVe0TBkM/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=cF1KVe0TBkM", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Arianespace Flight VA239 / Intelsat 37e and BSAT-4a", "description": "Flight VA239: Arianespace orbits Intelsat 37e and BSAT-4a on 81st successful Ariane 5 launch in a row Arianespace has successfully launched the Intelsat 37e ...", "feature_image": "https://i.ytimg.com/vi/4farSKUK-rs/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=4farSKUK-rs", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane252052520eca_image_20190224012333.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5678, "location_launch_attempt_count": 275, "pad_launch_attempt_count": 96, "agency_launch_attempt_count": 260, "orbital_launch_attempt_count_year": 63, "location_launch_attempt_count_year": 9, "pad_launch_attempt_count_year": 6, "agency_launch_attempt_count_year": 9, "pad_turnaround": "P93DT41M", "mission_patches": [], "type": "detailed" }