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/11ae4d7c-e83c-4a52-94b8-1cf79bd16d52/?format=api
{ "id": "11ae4d7c-e83c-4a52-94b8-1cf79bd16d52", "url": "https://ll.thespacedevs.com/2.2.0/launch/11ae4d7c-e83c-4a52-94b8-1cf79bd16d52/?format=api", "slug": "vega-ceres", "flightclub_url": null, "r_spacex_api_id": null, "name": "Vega | CERES", "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-14T03:49:40Z", "updates": [ { "id": 979, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/scottm3_profile_20210817212204.png", "comment": "Mission successful via webcast host and arianespace", "info_url": "https://twitter.com/Arianespace/status/1460554452746870790", "created_by": "scottm3", "created_on": "2021-11-16T10:28:24Z" }, { "id": 960, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Launch time confirmed by the Guiana Space Centre.", "info_url": "https://centrespatialguyanais.cnes.fr/fr/lancement-vega-vv20-16-novembre-2021", "created_by": "Nosu", "created_on": "2021-11-09T15:05:55Z" }, { "id": 930, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch date.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=54145.msg2306065#msg2306065", "created_by": "Cosmic_Penguin", "created_on": "2021-11-03T04:29:42Z" }, { "id": 926, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch date and time.", "info_url": "https://cnes-csg.reservationlancement.fr/en/Inscription/Lancements", "created_by": "Cosmic_Penguin", "created_on": "2021-10-31T08:20:16Z" } ], "net": "2021-11-16T09:27:55Z", "net_precision": null, "window_end": "2021-11-16T09:27:55Z", "window_start": "2021-11-16T09:27:55Z", "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": 128, "configuration": { "id": 167, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/167/?format=api", "name": "Vega", "active": false, "reusable": false, "description": "Vega is the smallest lifter in the current Arianespace family.", "family": "Vega", "full_name": "Vega", "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": 29.9, "diameter": 3.025, "maiden_flight": "2012-02-13", "launch_cost": "37000000", "launch_mass": 137, "leo_capacity": 1500, "gto_capacity": null, "to_thrust": 2974, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_image_20201111143622.jpeg", "info_url": "http://www.arianespace.com/vehicle/vega/", "wiki_url": "https://en.wikipedia.org/wiki/Vega_(rocket)", "total_launch_count": 22, "consecutive_successful_launches": 5, "successful_launches": 20, "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": 5881, "name": "CERES", "description": "CERES (CapacitÉ de Renseignement Électromagnétique Spatiale) is a space-based signal intelligence (SIGNIT) system consisting of three satellites constellation.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "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": [ { "priority": 10, "source": null, "title": "Vega Flight VV20", "description": "Arianespace’s twelfth launch of 2021 with the third Vega of the year will place its satellite passengers into Sun-synchronous orbit. The launcher will be carrying a total payload of approximately 1548 kg.\n\nThe launch will be performed in Kourou, French Guiana.", "feature_image": null, "url": "https://www.arianespace.com/mission/vega-flight-vv20/", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Vega CERES", "description": "Vega CERES with initial coverage and post coverage cutThumbnail Photo Credit: Arianespace", "feature_image": "https://i.ytimg.com/vi/JiNo08iTiu4/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=JiNo08iTiu4", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 9, "source": null, "publisher": null, "title": "Flight Arianespace VV20 – CERES", "description": "Twelfth launch by Arianespace in 2021, the Vega light launcher will lift off, for the third time this year, from the Guiana Space Center in Kourou, French Gu...", "feature_image": "https://i.ytimg.com/vi/akokMC3bS4w/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=akokMC3bS4w", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "[Live] VV20 CERES Launch on 2021/11/16", "description": "Vega will orbit CERES, 3 CERES Earth observation satellites for French defense applications. Launch on 2021/11/16 at 10:27 AM (Paris time). Stay tuned!https:...", "feature_image": "https://i.ytimg.com/vi/ti8qlouagqg/hqdefault_live.jpg", "url": "https://www.youtube.com/watch?v=ti8qlouagqg", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega_image_20201111143622.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6150, "location_launch_attempt_count": 309, "pad_launch_attempt_count": 46, "agency_launch_attempt_count": 304, "orbital_launch_attempt_count_year": 113, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 12, "pad_turnaround": "P91DT7H40M49S", "mission_patches": [ { "id": 592, "name": "CERES Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/ceres2520patch_mission_patch_20211112164946.png", "agency": { "id": 253, "url": "https://ll.thespacedevs.com/2.2.0/agencies/253/?format=api", "name": "French Armed Forces", "type": "Government" } } ], "type": "detailed" }
