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/8e6e8c0e-6abc-4af9-a5dc-1d0cfcdad25b/?format=api
{ "id": "8e6e8c0e-6abc-4af9-a5dc-1d0cfcdad25b", "url": "https://ll.thespacedevs.com/2.2.0/launch/8e6e8c0e-6abc-4af9-a5dc-1d0cfcdad25b/?format=api", "slug": "ariane-5-eca-dsn-1-hylas-4", "flightclub_url": null, "r_spacex_api_id": null, "name": "Ariane 5 ECA | DSN 1 & HYLAS 4", "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:19Z", "updates": [], "net": "2018-04-05T21:34:07Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2018-04-05T21:34:07Z", "window_start": "2018-04-05T21:34: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": 322, "consecutive_successful_launches": 10, "successful_launches": 307, "failed_launches": 15, "pending_launches": 36, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.arianespace.com", "wiki_url": "https://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": 1328, "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": 330, "name": "DSN 1 & HYLAS 4", "description": "DSN-1 (also known as Kirameki 1, Superbird 8 or Superbird B3) is Japanese X-band military communications satellite. It was planned to be launched in 2016, however the satellite was damaged during transport to the launch site and repairs delayed the launch. The satellite is to replace aging Superbird-B2 satellite at 162° East in geostationary orbit. HYLAS 4 is a communications satellite build by Orbital ATK for Avanti Communication. It features hybrid propulsion system, with traditional chemical thrusters for orbit raising and ion engines for stationkeeping. The satellite carries 66 high-throughput Ka-band beams and will provide services to regions of Africa and Europe.", "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": "https://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": 328, "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": "youtube.com", "publisher": "Centre spatial guyanais", "title": "Décollage du Vol Ariane 242 depuis le Centre spatial guyanais.", "description": "Nouveau succès pour Ariane 5 qui a parfaitement réussi sa mission depuis le Centre Spatial Guyanais (CSG), port spatial de l’Europe, en mettant en orbite les deux satellites de télécommunications, DSN...", "feature_image": "https://i.ytimg.com/vi/tS6wTpaV__A/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=tS6wTpaV__A", "type": null, "language": { "id": 4, "name": "French", "code": "fr" }, "start_time": "2018-04-05T23:53:25Z", "end_time": "2018-04-05T23:54:28Z" }, { "priority": 0, "source": "youtube.com", "publisher": "arianespace", "title": "Arianespace Vol VA242 - HYLAS 4 et DSN-1/Superbird-8 (FR)", "description": "To watch this launch in English, please click here:\nhttps://www.youtube.com/watch?v=VDEQ4U89zzU\n\nArianespace a lancé avec succès les satellites de télécommunication DSN-1/Superbird-8 et HYLAS 4 pour l...", "feature_image": "https://i.ytimg.com/vi/6BQXyhK0b-U/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=6BQXyhK0b-U", "type": null, "language": { "id": 4, "name": "French", "code": "fr" }, "start_time": "2018-04-05T21:18:05Z", "end_time": "2018-04-05T22:32:59Z" }, { "priority": 0, "source": "youtube.com", "publisher": "arianespace", "title": "Flight VA242 – HYLAS 4 / DSN-1/Superbird-8 | Ariane 5 Launch | Arianespace", "description": "Pour regarder le lancement en Français, veuillez cliquer ici:\nhttps://www.youtube.com/watch?v=6BQXyhK0b-U\n\nFLIGHT VA242 – ARIANESPACE TO LAUNCH DSN-1/SUPERBIRD-8\nFOR SKY PERFECT JSAT AND HYLAS 4 FOR A...", "feature_image": "https://i.ytimg.com/vi/VDEQ4U89zzU/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=VDEQ4U89zzU", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2018-04-05T21:18:10Z", "end_time": "2018-04-05T22:32:56Z" }, { "priority": 0, "source": "youtube.com", "publisher": "arianespace", "title": "Successful Mission Arianespace VA242 - HYLAS 4 et DSN-1/Superbird-8", "description": "Arianespace has successfully launched two telecommunications satellites: DSN-1/Superbird-8 for the Japanese operator SKY Perfect JSAT; and HYLAS 4 for the British operator Avanti Communications.\n\nAria...", "feature_image": "https://i.ytimg.com/vi/vsdYzuYcKiY/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=vsdYzuYcKiY", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2018-04-05T21:49:03Z", "end_time": "2018-04-05T21:50:03Z" }, { "priority": 0, "source": "youtube.com", "publisher": "arianespace", "title": "Flight VA242 | Ariane 5 Best of Liftoff | Arianespace", "description": "Arianespace has successfully launched two telecommunications satellites: DSN-1/Superbird-8 for the Japanese operator SKY Perfect JSAT; and HYLAS 4 for the British operator Avanti Communications.\n\nAria...", "feature_image": "https://i.ytimg.com/vi/HjNPzds7KfU/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=HjNPzds7KfU", "type": null, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2018-04-16T10:06:20Z", "end_time": "2018-04-16T10:07:59Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane252052520eca_image_20190224012333.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5739, "location_launch_attempt_count": 280, "pad_launch_attempt_count": 99, "agency_launch_attempt_count": 265, "orbital_launch_attempt_count_year": 33, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 3, "pad_turnaround": "P69DT23H14M7S", "mission_patches": [], "type": "detailed" }
