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/84a7f81c-2b95-4809-ba4b-dba4d178fd36/?format=api
{ "id": "84a7f81c-2b95-4809-ba4b-dba4d178fd36", "url": "https://ll.thespacedevs.com/2.3.0/launches/84a7f81c-2b95-4809-ba4b-dba4d178fd36/?format=api", "name": "Kosmos-2I 63S1 | DS-1 2", "response_mode": "detailed", "slug": "kosmos-2i-63s1-ds-1-2", "launch_designator": null, "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-06-14T04:19:16Z", "net": "1961-12-21T12:30:00Z", "net_precision": null, "window_end": "1961-12-21T12:30:00Z", "window_start": "1961-12-21T12:30:00Z", "image": { "id": 1756, "name": "[AUTO] Kosmos-2I 63S1 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/kosmos-2i252063s1_image_20191201205435.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193700.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": 0, "weather_concerns": null, "failreason": "Failed to reach orbit", "hashtag": "", "launch_service_provider": { "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": [] }, "rocket": { "id": 2407, "configuration": { "response_mode": "detailed", "id": 190, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/190/?format=api", "name": "Kosmos-2I 63S1", "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-2I", "variant": "", "active": false, "is_placeholder": false, "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": [] }, "program": [], "reusable": false, "image": { "id": 1756, "name": "[AUTO] Kosmos-2I 63S1 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/kosmos-2i252063s1_image_20191201205435.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193700.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Kosmos-2I", "description": "Kosmos-2I is the designation applied to two Soviet carrier rockets which were used to orbit satellites between 1961 and 1977.", "alias": "", "min_stage": 2, "max_stage": 2, "length": 31.0, "diameter": 1.6, "maiden_flight": "1961-10-27", "launch_cost": null, "launch_mass": 48.0, "leo_capacity": 300.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": null, "apogee": null, "total_launch_count": 38, "consecutive_successful_launches": 3, "successful_launches": 26, "failed_launches": 12, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P5DT3H" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": null, "pad": { "id": 100, "url": "https://ll.thespacedevs.com/2.3.0/pads/100/?format=api", "active": true, "agencies": [], "name": "Mayak-2", "image": null, "description": null, "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=48.569551,46.295814", "latitude": 48.569551, "longitude": 46.295814, "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_100_20200803143212.jpg", "total_launch_count": 24, "orbital_launch_attempt_count": 24, "fastest_turnaround": "P5DT3H", "location": { "response_mode": "normal", "id": 30, "url": "https://ll.thespacedevs.com/2.3.0/locations/30/?format=api", "name": "Kapustin Yar, 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": "Kapustin Yar is a Russian military training area and a rocket launch complex in Astrakhan Oblast, about 100 km east of Volgograd. It was established by the Soviet Union on 13 May 1946. In the beginning, Kapustin Yar used technology, material, and scientific support gained from the defeat of Germany in World War II. Numerous launches of test rockets for the Russian military were carried out at the site, as well as satellite and sounding rocket launches.", "image": { "id": 2204, "name": "R-2A and R-5A geophysical rockets on the pad", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/r-2a_and_r-5a_g_image_20240918155857.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/r-2a_and_r-5a_g_image_thumbnail_20240918155857.jpeg", "credit": "Mil.ru", "license": { "id": 30, "name": "CC BY 4.0", "priority": 4, "link": "https://creativecommons.org/licenses/by/4.0/" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_30_20200803142515.jpg", "longitude": 45.72, "latitude": 48.59, "timezone_name": "Europe/Volgograd", "total_launch_count": 101, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 141, "location_launch_attempt_count": 2, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 2, "orbital_launch_attempt_count_year": 141, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P54DT20H", "mission_patches": [] }
