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/7b412779-a9cd-442d-b067-1889a8f6b930/?format=api
{ "id": "7b412779-a9cd-442d-b067-1889a8f6b930", "url": "https://ll.thespacedevs.com/2.2.0/launch/7b412779-a9cd-442d-b067-1889a8f6b930/?format=api", "slug": "ariane-5-eca-ses-17-syracuse-4a", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ariane 5 ECA+ | SES-17 & Syracuse 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:24Z", "updates": [ { "id": 910, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Launch success confirmed", "info_url": "https://twitter.com/Arianespace/status/1452107424945606657", "created_by": "SwGustav", "created_on": "2021-10-24T03:07:53Z" }, { "id": 908, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Liftoff", "info_url": null, "created_by": "SwGustav", "created_on": "2021-10-24T02:10:48Z" }, { "id": 902, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch time.", "info_url": "https://twitter.com/Arianespace/status/1451786317591941126", "created_by": "Cosmic_Penguin", "created_on": "2021-10-23T06:32:41Z" }, { "id": 898, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Delayed due to additional checks on the ground support equipment", "info_url": "https://twitter.com/Arianespace/status/1451503817451769880", "created_by": "SwGustav", "created_on": "2021-10-22T11:28:14Z" }, { "id": 867, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch date & time announced by the Guiana Space Centre.", "info_url": "https://www.facebook.com/events/3013065502354394", "created_by": "Nosu", "created_on": "2021-10-11T19:18:18Z" } ], "net": "2021-10-24T02:10:00Z", "net_precision": null, "window_end": "2021-10-24T03:30:00Z", "window_start": "2021-10-24T01:01:00Z", "probability": -1, "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": 2686, "configuration": { "id": 215, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/215/?format=api", "name": "Ariane 5 ECA+", "active": false, "reusable": false, "description": "Ariane 5 ECA+ is a variant of the Ariane 5 heavy-lift vehicle, with a taller ECA-D upper stage.", "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": "2019-08-07", "launch_cost": null, "launch_mass": 780, "leo_capacity": null, "gto_capacity": 10200, "to_thrust": 11400, "apogee": null, "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": 11, "consecutive_successful_launches": 11, "successful_launches": 11, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1374, "name": "SES-17 & Syracuse 4A", "description": "SES-17 is a Ka-band high-throughput geostationary communications satellite built by Thales Alenia Space designed to provide mobile internet services to airline passengers over the Americas and the Atlantic Ocean. Syracuse 4A is a French military communications satellite built by Thales Alenia Space.", "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": [ { "priority": 10, "source": null, "title": "Ariane Flight VA255", "description": "Arianespace’s eleventh launch of 2021 with the second Ariane 5 of the year will place its satellite passengers into geostationary transfer orbit. The launcher will be carrying a total payload of approximately 11,210 kg.\n\nThe launch will be performed in Kourou, French Guiana.", "feature_image": null, "url": "https://www.arianespace.com/mission/ariane-flight-va255/", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Ariane V SES-17 & Syracuse 4A", "description": "Ariane V SES-17 & Syracuse 4A with initial coverage and post coverage cutThumbnail Photo Credit: ESA / CNES / Arianespace", "feature_image": "https://i.ytimg.com/vi/ZbfHZhFDBO0/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=ZbfHZhFDBO0", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "Flight Arianespace VA255 – SES-17 / SYRACUSE 4A", "description": "Arianespace’s next Ariane 5 launch from Europe’s Spaceport in French Guiana, is scheduled on Friday, October 22, 2021, during a launch window from 10:01 p.m....", "feature_image": "https://i.ytimg.com/vi/yYj9KqCwv48/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=yYj9KqCwv48", "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": 6140, "location_launch_attempt_count": 308, "pad_launch_attempt_count": 112, "agency_launch_attempt_count": 303, "orbital_launch_attempt_count_year": 103, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 11, "pad_turnaround": "P85DT5H10M", "mission_patches": [ { "id": 97, "name": "VA255 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/va2552520patch_mission_patch_20211021121057.png", "agency": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "type": "Commercial" } } ], "type": "detailed" }
