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/7690b919-288d-43aa-8e2f-f60b882b3f5a/?format=api
{ "id": "7690b919-288d-43aa-8e2f-f60b882b3f5a", "url": "https://ll.thespacedevs.com/2.3.0/launches/7690b919-288d-43aa-8e2f-f60b882b3f5a/?format=api", "name": "Rokot/Briz-KM | Gonets-M24, Gonets-M25, Gonets-M26 & Blits-M", "response_mode": "detailed", "slug": "rokotbriz-km-gonets-m24-gonets-m25-gonets-m26-blit", "launch_designator": "2019-096", "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:44Z", "net": "2019-12-26T23:11:57Z", "net_precision": null, "window_end": "2019-12-26T23:11:57Z", "window_start": "2019-12-26T23:11:57Z", "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": 193, "url": "https://ll.thespacedevs.com/2.3.0/agencies/193/?format=api", "name": "Russian Space Forces", "abbrev": "VKS", "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": "The Russian Space Forces are a branch of the Russian Aerospace Forces, that provides aerospace warning, air sovereignty, and protection for Russia. Having been reestablished following August 1, 2015 merger between the Russian Air Force and the Russian Aerospace Defence Forces after a 2011 dissolving of the branch. The Russian Space Forces were originally formed on August 10, 1992 and the creation of the Russian Armed Forces.", "administrator": "Commander: Aleksandr Golovko", "founding_year": 1992, "launchers": "", "spacecraft": "", "parent": "Russian Federal Space Agency (ROSCOSMOS)", "image": { "id": 26, "name": "[AUTO] Russian Space Forces - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520space2520forces_image_20191210085547.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184656.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 178, "name": "[AUTO] Russian Space Forces - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520space2520forces_logo_20200805185824.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185120.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 90, "name": "[AUTO] Russian Space Forces - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520space2520forces_nation_20230805154528.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184843.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 143, "consecutive_successful_launches": 55, "successful_launches": 135, "failed_launches": 8, "pending_launches": 2, "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": null, "wiki_url": "https://en.wikipedia.org/wiki/Russian_Aerospace_Forces", "social_media_links": [] }, "rocket": { "id": 4, "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": 866, "name": "Gonets-M24, Gonets-M25, Gonets-M26 & Blits-M", "type": "Communications", "description": "Gonets-M are an upgraded version of Gonets satellites, derived from military communications system Strela-3. Gonets-M constellation is tasked with monitoring ecological and industrial objects, providing communication and data transmission services, covering also the remote areas like the Far North region. Gonets-M satellites share the ride with the Blits-M microsatellite, which is a geodesic satellite tasked with determining precise orbit parameters for GLONASS satellites.", "image": null, "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO", "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": [], "orbital_launch_attempt_count": 5921, "location_launch_attempt_count": 1634, "pad_launch_attempt_count": 159, "agency_launch_attempt_count": 109, "orbital_launch_attempt_count_year": 101, "location_launch_attempt_count_year": 8, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 8, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [ { "priority": 0, "source": null, "publisher": null, "title": "Пуск ракеты-носителя легкого класса «Рокот» с космодрома Плесецк", "description": "В пятницу, 27 декабря, в 02 часа 11 минут (мск) с космодрома Плесецк в Архангельской области боевым расчетом Космических войск ВКС осуществлен пуск ракеты-но...", "feature_image": "https://i.ytimg.com/vi/-UFKmMjJze4/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=-UFKmMjJze4", "type": null, "language": null, "start_time": null, "end_time": null, "live": false } ], "timeline": [], "pad_turnaround": "P118DT9H11M43S", "mission_patches": [ { "id": 754, "name": "GLONASS Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/glonass_patch_20221127131342.png", "agency": { "response_mode": "list", "id": 193, "url": "https://ll.thespacedevs.com/2.3.0/agencies/193/?format=api", "name": "Russian Space Forces", "abbrev": "VKS", "type": { "id": 1, "name": "Government" } }, "response_mode": "normal" } ] }
