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/0a66785d-27f3-40b6-a719-19cbb6c5f48e/?format=api
{ "id": "0a66785d-27f3-40b6-a719-19cbb6c5f48e", "url": "https://ll.thespacedevs.com/2.2.0/launch/0a66785d-27f3-40b6-a719-19cbb6c5f48e/?format=api", "slug": "ariane-5-eca-sgdc-1-koreasat-7", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ariane 5 ECA | SGDC 1 & Koreasat 7", "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:00:49Z", "updates": [], "net": "2017-05-04T21:50:00Z", "net_precision": null, "window_end": "2017-05-04T23:19:00Z", "window_start": "2017-05-04T20:31: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": 1228, "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": 381, "name": "SGDC 1 & Koreasat 7", "description": "Both SGDC 1 and Koreasat 7 are geostationary telecommunications satellites. SGDC 1 is a 5800 kg satellite for Brazil, equipped with 50 Ka-band and 7 X-band transponders, and intended for both civil and military use. Koreasat 7 is to provide internet access, multimedia, broadcasting and fixed communications services to South Korea, Philippines, Indonesia and India. Satellite weighs around 3500 kg, and its operational lifetime is 15 years.", "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": "Arianespace Flight VA236 / Behind the Scenes of the Dream", "description": "Liftoff of Arianespace’s Ariane 5 with SGDC and KOREASAT-7 Arianespace orbited two telecommunications payloads for Brazil and South Korea on the 78th consecu...", "feature_image": "https://i.ytimg.com/vi/NA4s4w6px_E/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=NA4s4w6px_E", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Arianespace Vol VA236 / SGDC et KOREASAT-7 (VF)", "description": "Arianespace a lancé avec succès deux satellites de télécommunications : SGDC de la société VISIONA Tecnologia Espacial S.A. pour le compte de l’opérateur bré...", "feature_image": "https://i.ytimg.com/vi/YrE7nWS-7zc/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=YrE7nWS-7zc", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Arianespace Flight VA236 / SGDC and KOREASAT-7", "description": "Arianespace orbited two telecommunications payloads for Brazil and South Korea on the 78th consecutive success performed with its Ariane 5 – confirming this ...", "feature_image": "https://i.ytimg.com/vi/zGCgOyyZh_k/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=zGCgOyyZh_k", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Décollage du vol Ariane 236 depuis Kourou", "description": "Jeudi 4 mai, Ariane 5 a parfaitement réussi sa mission après son lancement depuis le Centre Spatial Guyanais (CSG), port spatial de l’Europe, en mettant en o...", "feature_image": "https://i.ytimg.com/vi/syYbJQ__2fc/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=syYbJQ__2fc", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Liftoff of Arianespace’s Ariane 5 with SGDC and KOREASAT-7", "description": "Arianespace has successfully launched two telecommunications satellites: SGDC for Visiona Tecnologia Espacial S.A, on behalf of the Brazilian operator Telebr...", "feature_image": "https://i.ytimg.com/vi/lOseNTOFbKQ/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=lOseNTOFbKQ", "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": 5639, "location_launch_attempt_count": 270, "pad_launch_attempt_count": 93, "agency_launch_attempt_count": 255, "orbital_launch_attempt_count_year": 24, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P79DT11M", "mission_patches": [], "type": "detailed" }
