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/64c621e9-331e-460e-a10e-b9a96626f208/?format=api
{ "id": "64c621e9-331e-460e-a10e-b9a96626f208", "url": "https://ll.thespacedevs.com/2.3.0/launches/64c621e9-331e-460e-a10e-b9a96626f208/?format=api", "name": "Kosmos-3M | Tsikada 19", "response_mode": "detailed", "slug": "kosmos-3m-tsikada-19", "launch_designator": "1993-001", "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": "1993-01-12T11:10:17Z", "net_precision": null, "window_end": "1993-01-12T11:10:17Z", "window_start": "1993-01-12T11:10:17Z", "image": null, "infographic": null, "probability": null, "weather_concerns": null, "failreason": null, "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 154, "url": "https://ll.thespacedevs.com/2.3.0/agencies/154/?format=api", "name": "Production Corporation Polyot", "abbrev": "NP", "type": { "id": 3, "name": "Commercial" }, "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": null, "image": null, "logo": null, "social_logo": null, "total_launch_count": 57, "consecutive_successful_launches": 21, "successful_launches": 55, "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.polyot.su/", "wiki_url": "https://en.wikipedia.org/wiki/Production_Corporation_Polyot", "social_media_links": [] }, "rocket": { "id": 6498, "configuration": { "response_mode": "detailed", "id": 102, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/102/?format=api", "name": "Kosmos-3M", "families": [ { "response_mode": "detailed", "id": 97, "name": "Kosmos", "manufacturer": [ { "response_mode": "normal", "id": 270, "url": "https://ll.thespacedevs.com/2.3.0/agencies/270/?format=api", "name": "Strategic Rocket Forces", "abbrev": "RVSN RF", "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 Strategic Rocket Forces of the Russian Federation are a separate-troops branch of the Russian Armed Forces that control Russia's land-based intercontinental ballistic missiles (ICBMs).", "administrator": null, "founding_year": 1959, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": { "id": 188, "name": "[AUTO] Strategic Rocket Forces - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/strategic2520rocket2520forces_logo_20220309203231.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185142.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 70, "name": "[AUTO] Khrunichev State Research and Production Space Center - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/khrunichev2520state2520research2520and2520production2520space2520center_nation_20190207032444.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184814.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "total_launch_count": 15, "consecutive_successful_launches": 1, "successful_launches": 12, "failed_launches": 3, "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": null, "wiki_url": "https://en.wikipedia.org/wiki/Strategic_Missile_Troops", "social_media_links": [] } ], "parent": null, "description": "", "active": false, "maiden_flight": "1964-08-18", "total_launch_count": 621, "consecutive_successful_launches": 22, "successful_launches": 576, "failed_launches": 45, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Kosmos-3M (11K65M)", "variant": "-3M", "active": false, "is_placeholder": false, "manufacturer": { "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": [] }, "program": [], "reusable": false, "image": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Kosmos-3M", "description": "N/A", "alias": "", "min_stage": null, "max_stage": null, "length": null, "diameter": null, "maiden_flight": "1967-05-15", "launch_cost": null, "launch_mass": null, "leo_capacity": null, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": null, "apogee": null, "total_launch_count": 445, "consecutive_successful_launches": 22, "successful_launches": 423, "failed_launches": 22, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "PT6H39M2S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 4888, "name": "Tsikada 19", "type": "Navigation", "description": "Civilian navigation satellite equivalent to the purely military Parus", "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": 3786, "location_launch_attempt_count": 1415, "pad_launch_attempt_count": 124, "agency_launch_attempt_count": 8, "orbital_launch_attempt_count_year": 1, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P75DT29M44S", "mission_patches": [] }
