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/9009b780-e843-4f35-accf-8f65e619d40f/?format=api
{ "id": "9009b780-e843-4f35-accf-8f65e619d40f", "url": "https://ll.thespacedevs.com/2.2.0/launch/9009b780-e843-4f35-accf-8f65e619d40f/?format=api", "slug": "vega-c-pleiades-neo-5-6", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vega-C | Pléiades Neo 5 & 6", "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-11-07T09:36:12Z", "updates": [ { "id": 3058, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Launch vehicle has failed at some point during second stage's burn, waiting for more details", "info_url": "https://www.youtube.com/watch?v=CokbWoYm9w4", "created_by": "SwGustav", "created_on": "2022-12-21T02:02:05Z" }, { "id": 3057, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Liftoff", "info_url": "https://www.youtube.com/watch?v=CokbWoYm9w4", "created_by": "SwGustav", "created_on": "2022-12-21T01:48:12Z" }, { "id": 3056, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Coverage live", "info_url": "https://www.youtube.com/watch?v=CokbWoYm9w4", "created_by": "SwGustav", "created_on": "2022-12-21T01:33:40Z" }, { "id": 2935, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Updating date and setting GO", "info_url": "https://www.intelligence-airbusds.com/", "created_by": "Nosu", "created_on": "2022-11-30T21:29:12Z" }, { "id": 2930, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch time.", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Cosmic_Penguin", "created_on": "2022-11-30T08:01:24Z" }, { "id": 2900, "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:44Z" }, { "id": 2898, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch postponed to NET December due to a defective equipment on the launcher.", "info_url": "https://twitter.com/Arianespace/status/1595809823739842560", "created_by": "Nosu", "created_on": "2022-11-24T16:02:43Z" }, { "id": 2772, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Updating date, adding T-0 and setting GO", "info_url": "https://cnes-csg.reservationlancement.fr/en/Inscription/Lancements", "created_by": "Nosu", "created_on": "2022-11-08T12:53:31Z" }, { "id": 2591, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Targeting November 23", "info_url": "https://www.dlr.de/rd/desktopdefault.aspx/tabid-4926/8178_read-47362/", "created_by": "Nosu", "created_on": "2022-10-14T10:19:00Z" } ], "net": "2022-12-21T01:47:31Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2022-12-21T01:47:31Z", "window_start": "2022-12-21T01:47:31Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "2nd stage Zefiro 40 motor lost chamber pressure from T+151 seconds due to unexpected erosion of carbon-carbon (C-C) material in the motor nozzle's throat insert, caused by the material's flaw in homogeneity.", "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": 7608, "configuration": { "id": 127, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/127/?format=api", "name": "Vega-C", "active": true, "reusable": false, "description": "Vega-C is a single-body rocket nearly 35 m high with that weighs 210 tonnes on the launch pad. As with Vega, its main elements are three solid-propellant stages, an upper stage powered by a reignitable liquid-propellant engine and a payload fairing. Vega-C's P120C first stage replaces Vega’s smaller P80 to provide a significant increase in thrust at liftoff. It is also used as boosters (2 or 4) for the Ariane 6 rocket.", "family": "Vega", "full_name": "Vega-C", "manufacturer": { "id": 159, "url": "https://ll.thespacedevs.com/2.2.0/agencies/159/?format=api", "name": "Avio S.p.A", "featured": true, "type": "Commercial", "country_code": "ITA", "abbrev": "Avio", "description": "Avio S.p.A. is an Italian company operating in the aerospace sector with its head office in Colleferro near Rome, Italy. Founded in 1908, it is present in Italy and abroad with different commercial offices and 10 production sites.", "administrator": "CEO: Giulio Ranzo", "founding_year": "1908", "launchers": "Vega", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 3, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.avio.com/", "wiki_url": "http://en.wikipedia.org/wiki/Avio", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio2520s.p.a_logo_20221130103121.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/avio_social_log_image_20250211190007.jpg" }, "program": [], "variant": "", "alias": "", "min_stage": 4, "max_stage": 4, "length": 35.0, "diameter": 3.0, "maiden_flight": "2022-07-13", "launch_cost": "48000000", "launch_mass": 210, "leo_capacity": 3300, "gto_capacity": null, "to_thrust": 2974, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "info_url": "http://www.arianespace.com/vehicle/vega/", "wiki_url": "https://en.wikipedia.org/wiki/Vega_(rocket)", "total_launch_count": 4, "consecutive_successful_launches": 2, "successful_launches": 3, "failed_launches": 1, "pending_launches": 23, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6153, "name": "Pléiades Neo 5 & 6", "description": "Pléiades Neo 5 and 6 are the last two in a constellation of four optical high-resolution Earth observation satellites built and operated by Airbus. It is a dual purpose constellation, serving both civilian and military purposes.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 34, "url": "https://ll.thespacedevs.com/2.2.0/pad/34/?format=api", "agency_id": 115, "name": "Ariane Launch Area 1 (ELV)", "description": "ELA-1, now named Ensemble de Lancement Vega (short ELV), is a launch pad at the Centre Spatial Guyanais in French Guiana. It has been used to support launches of the Europa rocket, Ariane 1, Ariane 3, and is currently used to launch Vega rockets.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/ELA-1", "map_url": "https://www.google.com/maps?q=5.236,-52.775", "latitude": "5.236", "longitude": "-52.775", "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_34_20200803143527.jpg", "total_launch_count": 52, "orbital_launch_attempt_count": 52 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "Flight VV22 – Completing the band! | Pleiades Neo 5 & 6 | 1st Vega C launch operated by Arianespace", "description": "ARIANESPACE’S FIRST VEGA C MISSION TO COMPLETE PLÉIADES NEO CONSTELLATION FOR AIRBUS DEFENCE AND SPACEArianespace’s upcoming Vega C launch, scheduled for Dec...", "feature_image": "https://i.ytimg.com/vi/CokbWoYm9w4/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=CokbWoYm9w4", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6364, "location_launch_attempt_count": 317, "pad_launch_attempt_count": 48, "agency_launch_attempt_count": 312, "orbital_launch_attempt_count_year": 182, "location_launch_attempt_count_year": 6, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P160DT12H34M14S", "mission_patches": [], "type": "detailed" }
