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/450e6a91-8f22-45dc-a4ee-acfac0702cdf/?format=api
{ "id": "450e6a91-8f22-45dc-a4ee-acfac0702cdf", "url": "https://ll.thespacedevs.com/2.2.0/launch/450e6a91-8f22-45dc-a4ee-acfac0702cdf/?format=api", "slug": "ariane-5-eca-galaxy-35-36-mtg-i1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ariane 5 ECA+ | Galaxy 35 & 36, MTG-I1", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-06-15T14:14:47Z", "updates": [ { "id": 3010, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Successful deployment and signal acquisition from MTG-I1 and both Galaxy satellites (https://twitter.com/INTELSAT/status/1602782247207272449)", "info_url": "https://twitter.com/ESA_EO/status/1602782609930539009", "created_by": "SwGustav", "created_on": "2022-12-13T21:52:26Z" }, { "id": 3009, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Liftoff", "info_url": "https://www.youtube.com/watch?v=bJP-GjxqumU", "created_by": "Nosu", "created_on": "2022-12-13T20:30:21Z" }, { "id": 3008, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Live coverage has started", "info_url": "https://www.youtube.com/watch?v=bJP-GjxqumU", "created_by": "Nosu", "created_on": "2022-12-13T20:05:17Z" }, { "id": 2987, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Refined launch window.", "info_url": "https://www.arianespace.com/wp-content/uploads/2022/12/VA259-launchkit-EN.pdf", "created_by": "Cosmic_Penguin", "created_on": "2022-12-09T18:10:12Z" }, { "id": 2964, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Setting GO", "info_url": "https://cnes-csg.reservationlancement.fr/en/Inscription/Lancements", "created_by": "Nosu", "created_on": "2022-12-07T12:47:58Z" }, { "id": 2919, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch time.", "info_url": "https://www.eumetsat.int/our-satellites/upcoming-launches", "created_by": "Cosmic_Penguin", "created_on": "2022-11-29T05:34:52Z" }, { "id": 2899, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch date.", "info_url": "https://twitter.com/Arianespace/status/1596096579718770689", "created_by": "Cosmic_Penguin", "created_on": "2022-11-25T11:09:13Z" }, { "id": 2592, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Targeting December 14", "info_url": "https://www.dlr.de/rd/desktopdefault.aspx/tabid-4926/8178_read-5116/", "created_by": "Nosu", "created_on": "2022-10-14T10:19:39Z" } ], "net": "2022-12-13T20:30:07Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2022-12-13T22:16:00Z", "window_start": "2022-12-13T20:30: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": 7512, "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": 5922, "name": "Galaxy 35 & 36, MTG-I1", "description": "Galaxy 35, 36 are two geostationary communications satellites operated by Intelsat.\r\nMTG-I1 is the first of EUMETSAT's third generation of weather satellite.", "launch_designator": null, "type": "Earth Science", "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 VA259", "description": "Arianespace’s fourth launch of 2022 with the third Ariane 5 of the year will place its satellite passengers into geostationary transfer orbit. The launcher will be carrying a total payload of approximately 10,972 kg.", "feature_image": null, "url": "https://www.arianespace.com/mission/ariane-flight-va259/", "type": null, "language": null } ], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "Flight VA259 – State-of-the-art | Galaxy 35 and 36 / MTG-I1 | Ariane 5 Launch | Arianespace", "description": "On Tuesday, December 13, 2022 at 5:30 p.m. local time (8:30 p.m. UTC), Arianespace’s next Ariane 5 mission will lift off from Europe’s Spaceport, French Guia...", "feature_image": "https://i.ytimg.com/vi/bJP-GjxqumU/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=bJP-GjxqumU", "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": 6357, "location_launch_attempt_count": 316, "pad_launch_attempt_count": 116, "agency_launch_attempt_count": 311, "orbital_launch_attempt_count_year": 175, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P96DT22H45M", "mission_patches": [ { "id": 755, "name": "VA259 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/va259_patch_20221213200110.png", "agency": { "id": 115, "url": "https://ll.thespacedevs.com/2.2.0/agencies/115/?format=api", "name": "Arianespace", "type": "Commercial" } } ], "type": "detailed" }
