Launch Instance
Modes
Levels of detail in the response - list, normal, detailed
Example - /launches/?mode=list
Filters
Parameters - agency_launch_attempt_count, agency_launch_attempt_count__gt, agency_launch_attempt_count__gte, agency_launch_attempt_count__lt, agency_launch_attempt_count__lte, agency_launch_attempt_count_year, agency_launch_attempt_count_year__gt, agency_launch_attempt_count_year__gte, agency_launch_attempt_count_year__lt, agency_launch_attempt_count_year__lte, day, id, include_suborbital, is_crewed, last_updated__gte, last_updated__lte, launch_designator, launcher_config__id, location__ids, location_launch_attempt_count, location_launch_attempt_count__gt, location_launch_attempt_count__gte, location_launch_attempt_count__lt, location_launch_attempt_count__lte, location_launch_attempt_count_year, location_launch_attempt_count_year__gt, location_launch_attempt_count_year__gte, location_launch_attempt_count_year__lt, location_launch_attempt_count_year__lte, lsp__id, lsp__name, mission__orbit__celestial_body__id, mission__orbit__name, mission__orbit__name__icontains, month, name, net__gt, net__gte, net__lt, net__lte, orbital_launch_attempt_count, orbital_launch_attempt_count__gt, orbital_launch_attempt_count__gte, orbital_launch_attempt_count__lt, orbital_launch_attempt_count__lte, orbital_launch_attempt_count_year, orbital_launch_attempt_count_year__gt, orbital_launch_attempt_count_year__gte, orbital_launch_attempt_count_year__lt, orbital_launch_attempt_count_year__lte, pad, pad__location, pad__location__celestial_body__id, pad_launch_attempt_count, pad_launch_attempt_count__gt, pad_launch_attempt_count__gte, pad_launch_attempt_count__lt, pad_launch_attempt_count__lte, pad_launch_attempt_count_year, pad_launch_attempt_count_year__gt, pad_launch_attempt_count_year__gte, pad_launch_attempt_count_year__lt, pad_launch_attempt_count_year__lte, program, related_lsp__id, related_lsp__name, rocket__configuration__full_name, rocket__configuration__full_name__icontains, rocket__configuration__id, rocket__configuration__manufacturer__name, rocket__configuration__manufacturer__name__icontains, rocket__configuration__name, rocket__spacecraftflight__spacecraft__id, rocket__spacecraftflight__spacecraft__name, rocket__spacecraftflight__spacecraft__name__icontains, serial_number, slug, spacecraft_config__ids, status, status__ids, video_url, window_end__gt, window_end__gte, window_end__lt, window_end__lte, window_start__gt, window_start__gte, window_start__lt, window_start__lte, year
Example - /launches/?pad__location=13
Search
Fields searched - launch_designator, launch_service_provider__name, mission__name, name, pad__location__name, pad__name, rocket__configuration__manufacturer__abbrev, rocket__configuration__manufacturer__name, rocket__configuration__name, rocket__spacecraftflight__spacecraft__name
Example - /launches/?search=Starlink
Ordering
Fields - id, last_updated, name, net
Example - /launches/?ordering=-last_updated
Number of results
Use limit to control the number of objects in the response (max 100)
Example - /launches/?limit=2
Format
Switch to JSON output - /launches/?format=json
Help
Find all the FAQs and support links on the documentation homepage - ll.thespacedevs.com/docs
GET /2.3.0/launches/aea09ab5-4aee-412d-a2c8-9d340116c486/?format=api
{ "id": "aea09ab5-4aee-412d-a2c8-9d340116c486", "url": "https://ll.thespacedevs.com/2.3.0/launches/aea09ab5-4aee-412d-a2c8-9d340116c486/?format=api", "name": "Rokot / Briz-KM | Sentinel-3A", "response_mode": "detailed", "slug": "rokot-briz-km-sentinel-3a", "launch_designator": "2016-011", "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:31:43Z", "net": "2016-02-16T17:57:40Z", "net_precision": null, "window_end": "2016-02-16T17:57:40Z", "window_start": "2016-02-16T17:57:40Z", "image": { "id": 1816, "name": "Rockot liftoff from Plesetsk Cosmodrome (Sentinel-3A)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rokot25202f2520briz-km_image_20190224012237.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193839.jpeg", "credit": "ESA/Stephane Corvaja", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": false, "variants": [] }, "infographic": null, "probability": -1, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 117, "url": "https://ll.thespacedevs.com/2.3.0/agencies/117/?format=api", "name": "Eurockot Launch Services", "abbrev": "ELS", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 1, "name": "France", "alpha_2_code": "FR", "alpha_3_code": "FRA", "nationality_name": "French", "nationality_name_composed": "Franco" }, { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" } ], "description": "Eurockot Launch Services GmbH is a commercial spacecraft launch provider and was founded in 1995. Eurockot uses an expendable launch vehicle called the Rockot to place satellites into low Earth orbit (LEO). Eurockot is jointly owned by ArianeGroup, which holds 51 percent, and by Khrunichev State Research and Production Space Center, which holds 49 percent. Eurockot launches from dedicated launch facilities at the Plesetsk Cosmodrome in northern Russia.", "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 14, "consecutive_successful_launches": 8, "successful_launches": 13, "failed_launches": 1, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "http://www.eurockot.com/", "wiki_url": "http://en.wikipedia.org/wiki/Eurockot_Launch_Services", "social_media_links": [] }, "rocket": { "id": 1909, "configuration": { "response_mode": "detailed", "id": 40, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/40/?format=api", "name": "Rokot/Briz-KM", "families": [ { "response_mode": "detailed", "id": 134, "name": "Rokot", "manufacturer": [ { "response_mode": "normal", "id": 163, "url": "https://ll.thespacedevs.com/2.3.0/agencies/163/?format=api", "name": "Russian Aerospace Defence Forces", "abbrev": "VKO", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": "Russian Federal Space Agency (ROSCOSMOS)", "image": null, "logo": null, "social_logo": null, "total_launch_count": 22, "consecutive_successful_launches": 17, "successful_launches": 20, "failed_launches": 2, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "http://www.eng.mil.ru/en/structure/forces/cosmic.htm", "wiki_url": "http://en.wikipedia.org/wiki/Russian_Aerospace_Defence_Forces", "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "1994-12-26", "total_launch_count": 32, "consecutive_successful_launches": 14, "successful_launches": 29, "failed_launches": 3, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Rokot/Briz-KM", "variant": "Briz-KM", "active": true, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 163, "url": "https://ll.thespacedevs.com/2.3.0/agencies/163/?format=api", "name": "Russian Aerospace Defence Forces", "abbrev": "VKO", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": "Russian Federal Space Agency (ROSCOSMOS)", "image": null, "logo": null, "social_logo": null, "total_launch_count": 22, "consecutive_successful_launches": 17, "successful_launches": 20, "failed_launches": 2, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 0, "failed_landings_spacecraft": 0, "attempted_landings_spacecraft": 0, "successful_landings_payload": 0, "failed_landings_payload": 0, "attempted_landings_payload": 0, "info_url": "http://www.eng.mil.ru/en/structure/forces/cosmic.htm", "wiki_url": "http://en.wikipedia.org/wiki/Russian_Aerospace_Defence_Forces", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 1816, "name": "Rockot liftoff from Plesetsk Cosmodrome (Sentinel-3A)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rokot25202f2520briz-km_image_20190224012237.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193839.jpeg", "credit": "ESA/Stephane Corvaja", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": false, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Rokot", "description": "", "alias": "", "min_stage": 1, "max_stage": 3, "length": 29.0, "diameter": 2.5, "maiden_flight": "2000-05-16", "launch_cost": null, "launch_mass": 107.0, "leo_capacity": 1850.0, "gto_capacity": 0.0, "geo_capacity": null, "sso_capacity": null, "to_thrust": 1870.0, "apogee": 1500.0, "total_launch_count": 31, "consecutive_successful_launches": 14, "successful_launches": 28, "failed_launches": 3, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P32DT12H29M26S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 894, "name": "Sentinel-3A", "type": "Earth Science", "description": "Sentinel-3A is the first in a pair of earth observation satellites developed by ESA to provide near real time data for the GMES Program. Sentinel-3A contains a temperature scanner, colour instrument and altimeter for monitoring the sea and land. The satellite focuses on providing accurate data about the oceans and in addition also provides information about wildfires and vegetation.", "image": null, "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 3, "url": "https://ll.thespacedevs.com/2.3.0/pads/3/?format=api", "active": true, "agencies": [ { "response_mode": "normal", "id": 163, "url": "https://ll.thespacedevs.com/2.3.0/agencies/163/?format=api", "name": "Russian Aerospace Defence Forces", "abbrev": "VKO", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" } ], "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": "Russian Federal Space Agency (ROSCOSMOS)", "image": null, "logo": null, "social_logo": null } ], "name": "133/3 (133L)", "image": null, "description": null, "info_url": null, "wiki_url": "", "map_url": "https://www.google.com/maps?q=62.886999,40.846984", "latitude": 62.886999, "longitude": 40.846984, "country": { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_3_20200803143438.jpg", "total_launch_count": 159, "orbital_launch_attempt_count": 159, "fastest_turnaround": "P3DT23H30M", "location": { "response_mode": "normal", "id": 6, "url": "https://ll.thespacedevs.com/2.3.0/locations/6/?format=api", "name": "Plesetsk Cosmodrome, Russian Federation", "celestial_body": { "response_mode": "normal", "id": 1, "name": "Earth", "type": { "id": 1, "name": "Planet" }, "diameter": 12742000.0, "mass": 5.972168e+24, "gravity": 9.80655, "length_of_day": "1 00:00:00", "atmosphere": true, "image": { "id": 2040, "name": "Earth (Apollo 17)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_thumbnail_20240402194305.jpeg", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "description": "Earth is the third planet from the Sun and the only astronomical object known to harbor life.", "wiki_url": "https://en.wikipedia.org/wiki/Earth", "total_attempted_launches": 7147, "successful_launches": 6604, "failed_launches": 543, "total_attempted_landings": 1101, "successful_landings": 1058, "failed_landings": 43 }, "active": true, "country": { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" }, "description": "Plesetsk Cosmodrome is a Russian spaceport located in Mirny, Arkhangelsk Oblast, about 800 km north of Moscow and approximately 200 km south of Arkhangelsk. Originally developed as an ICBM site for the R-7 missile, it also served for numerous satellite launches using the R-7 and other rockets. Its high latitude makes it useful only for certain types of launches, especially the Molniya orbits, so for much of the site's history it functioned as a secondary location, with most orbital launches taking place from Baikonur, in the Kazakh SSR. With the end of the Soviet Union, Baikonur became a foreign territory, and Kazakhstan charged $115 million usage fees annually. Consequently, Plesetsk has seen considerably more activity since the 2000s.", "image": { "id": 1461, "name": "Soyuz 2.1b/Fregat-M liftoff from pad 43/3 (Glonass-K2 No. 13, Kosmos 2569)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1b_image_20230807181912.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192834.jpeg", "credit": "Mil.ru", "license": { "id": 30, "name": "CC BY 4.0", "priority": 4, "link": "https://creativecommons.org/licenses/by/4.0/" }, "single_use": false, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_6_20200803142434.jpg", "longitude": 40.577778, "latitude": 62.925556, "timezone_name": "Europe/Moscow", "total_launch_count": 1674, "total_landing_count": 0 } }, "webcast_live": false, "program": [ { "response_mode": "normal", "id": 22, "url": "https://ll.thespacedevs.com/2.3.0/programs/22/?format=api", "name": "Copernicus", "image": { "id": 1879, "name": "[AUTO] Copernicus - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/copernicus_program_20221129162831.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194023.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": "https://www.copernicus.eu", "wiki_url": "https://en.wikipedia.org/wiki/Copernicus_Programme", "description": "Copernicus is the European Union's Earth observation programme coordinated and managed for the European Commission by the European Union Agency for the Space Programme in partnership with the European Space Agency (ESA), the EU Member States. It aims at achieving a global, continuous, autonomous, high quality, wide range Earth observation capacity. Providing accurate, timely and easily accessible information to, among other things, improve the management of the environment, understand and mitigate the effects of climate change, and ensure civil security.", "agencies": [ { "response_mode": "list", "id": 27, "url": "https://ll.thespacedevs.com/2.3.0/agencies/27/?format=api", "name": "European Space Agency", "abbrev": "ESA", "type": { "id": 2, "name": "Multinational" } }, { "response_mode": "list", "id": 1043, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1043/?format=api", "name": "European Union Agency for the Space Programme", "abbrev": "EUSPA", "type": { "id": 2, "name": "Multinational" } } ], "start_date": "2014-04-03T00:00:00Z", "end_date": null, "mission_patches": [], "type": { "id": 8, "name": "Earth Observation" } } ], "orbital_launch_attempt_count": 5540, "location_launch_attempt_count": 1612, "pad_launch_attempt_count": 153, "agency_launch_attempt_count": 12, "orbital_launch_attempt_count_year": 11, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [ { "priority": 0, "source": null, "publisher": null, "title": "Sentinel-3A liftoff", "description": "Replay of the Sentinel-3A liftoff on a Rockot launcher from the Plesetsk Cosmodrome in northern Russia at 17:57 GMT (18:57 CET) on 16 February 2016. Sentinel...", "feature_image": "https://i.ytimg.com/vi/1ipvoTzj1yc/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=1ipvoTzj1yc", "type": null, "language": null, "start_time": null, "end_time": null, "live": false } ], "timeline": [], "pad_turnaround": "P145DT19H58M2S", "mission_patches": [] }
