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/23cea0c4-31db-4daf-a443-6afaed6d42db/?format=api
{ "id": "23cea0c4-31db-4daf-a443-6afaed6d42db", "url": "https://ll.thespacedevs.com/2.2.0/launch/23cea0c4-31db-4daf-a443-6afaed6d42db/?format=api", "slug": "ariane-5-g-pas-1r-amsat-p3d-strv-1c-strv-1d", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ariane 5 G | PAS-1R, Amsat P3D, STRV 1C, STRV 1D", "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:17:05Z", "updates": [], "net": "2000-11-16T01:07:07Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2000-11-16T01:07:07Z", "window_start": "2000-11-16T01:07:07Z", "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": 460, "configuration": { "id": 131, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/131/?format=api", "name": "Ariane 5 G", "active": false, "reusable": false, "description": "The original version is dubbed Ariane 5 G (Generic) and had a launch mass of 737 tonnes. Its payload capability to geostationary transfer orbit (GTO) was 6,900 kg (15,200 lb) for a single satellite or 6,100 kg (13,400 lb) for dual launches. It flew 17 times with one failure and two partial failures.", "family": "Ariane", "full_name": "Ariane 5 G", "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": "G", "alias": "", "min_stage": 0, "max_stage": 2, "length": 57.0, "diameter": 5.4, "maiden_flight": "1996-06-04", "launch_cost": null, "launch_mass": 737, "leo_capacity": 12200, "gto_capacity": 6900, "to_thrust": null, "apogee": 40000, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane252052520g_image_20190222030331.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Ariane_5", "total_launch_count": 16, "consecutive_successful_launches": 6, "successful_launches": 13, "failed_launches": 3, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 582, "name": "PAS-1R, Amsat P3D, STRV 1C, STRV 1D", "description": "PAS-1R a commications satellite located at 40 degrees west, serving the Americas, the Caribbean, Europe and Africa, operated by PanAmSat. Amsat P3D was an amateur radio satellite built and operated by AmSat. STRV was a series of four satellites operated by the UK MoD, intended to test new technologies, two were launched on this vehicle.", "launch_designator": null, "type": "Dedicated Rideshare", "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": "AMSAT P3-D: Countdown and Launch with Ariane 507, V135", "description": "The launch of AMSAT OSCAR-40 (P3-D) with Ariane-5 (AR507, Vol. 135) as a secondary payload. PAS-1R for Panamsat was the primary payload. Two microsats for DE...", "feature_image": "https://i.ytimg.com/vi/8ePhqQb5vzY/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=8ePhqQb5vzY", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane252052520g_image_20190222030331.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 4441, "location_launch_attempt_count": 144, "pad_launch_attempt_count": 7, "agency_launch_attempt_count": 131, "orbital_launch_attempt_count_year": 74, "location_launch_attempt_count_year": 10, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 10, "pad_turnaround": "P62DT2H13M", "mission_patches": [], "type": "detailed" }
