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/fb233cd7-a50d-4583-8b7a-9f3620e0cbd0/?format=api
{ "id": "fb233cd7-a50d-4583-8b7a-9f3620e0cbd0", "url": "https://ll.thespacedevs.com/2.3.0/launches/fb233cd7-a50d-4583-8b7a-9f3620e0cbd0/?format=api", "name": "Start-1 | EROS A1", "response_mode": "detailed", "slug": "start-1-eros-a1", "launch_designator": "2000-079", "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-14T04:23:09Z", "net": "2000-12-05T12:32:00Z", "net_precision": null, "window_end": "2000-12-05T12:32:00Z", "window_start": "2000-12-05T12:32:00Z", "image": null, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "", "hashtag": null, "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": 7027, "configuration": { "response_mode": "detailed", "id": 381, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/381/?format=api", "name": "Start-1", "families": [ { "response_mode": "detailed", "id": 157, "name": "Start", "manufacturer": [ { "response_mode": "normal", "id": 1011, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1011/?format=api", "name": "Moscow Institute of Thermal Technology", "abbrev": "MITT", "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": "Moscow Institute of Thermal Technology is a Russian (formerly Soviet) engineering and scientific research institute founded on May 13, 1946. The institute is located in the Otradnoye District in the north of Moscow.\r\n\r\nPreviously, it was primarily focused on developing ballistic missiles and rockets to increase the nation's strategic deterrent capability. Today it is also involved in civilian projects and has modified some of its intercontinental ballistic missiles into launch vehicles to be used for satellites.", "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": "Russian Federal Space Agency (ROSCOSMOS)", "image": null, "logo": null, "social_logo": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "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/Moscow_Institute_of_Thermal_Technology", "social_media_links": [] } ], "parent": null, "description": "", "active": false, "maiden_flight": "1993-03-25", "total_launch_count": 7, "consecutive_successful_launches": 5, "successful_launches": 6, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Start-1", "variant": "1", "active": false, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1011, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1011/?format=api", "name": "Moscow Institute of Thermal Technology", "abbrev": "MITT", "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": "Moscow Institute of Thermal Technology is a Russian (formerly Soviet) engineering and scientific research institute founded on May 13, 1946. The institute is located in the Otradnoye District in the north of Moscow.\r\n\r\nPreviously, it was primarily focused on developing ballistic missiles and rockets to increase the nation's strategic deterrent capability. Today it is also involved in civilian projects and has modified some of its intercontinental ballistic missiles into launch vehicles to be used for satellites.", "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": "Russian Federal Space Agency (ROSCOSMOS)", "image": null, "logo": null, "social_logo": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "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/Moscow_Institute_of_Thermal_Technology", "social_media_links": [] }, "program": [], "reusable": false, "image": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Start-1", "description": "Start-1 is a Russian satellite launch vehicle based on the RT-2PM Topol, a Soviet intercontinental ballistic missile developed by Moscow Institute of Thermal Technology.", "alias": "", "min_stage": 4, "max_stage": 4, "length": 22.7, "diameter": 1.61, "maiden_flight": "1993-03-25", "launch_cost": 9000000, "launch_mass": 47.0, "leo_capacity": 632.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": null, "to_thrust": 887.0, "apogee": null, "total_launch_count": 5, "consecutive_successful_launches": 5, "successful_launches": 5, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P76DT20H16M27S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 5416, "name": "EROS A1", "type": "Earth Science", "description": "EROS A (Earth Resources Observation Systems A) is the first in a constellation of sun-synchronous, polar-orbiting satellites that ImageSat plans to deploy during this decade.", "image": null, "orbit": { "id": 13, "name": "Polar Orbit", "abbrev": "PO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 128, "url": "https://ll.thespacedevs.com/2.3.0/pads/128/?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": "5", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Svobodny_Cosmodrome", "map_url": "https://www.google.com/maps?q=51.7,127.997806", "latitude": 51.7, "longitude": 127.997806, "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_128_20200803143250.jpg", "total_launch_count": 5, "orbital_launch_attempt_count": 5, "fastest_turnaround": "P76DT20H16M27S", "location": { "response_mode": "normal", "id": 146, "url": "https://ll.thespacedevs.com/2.3.0/locations/146/?format=api", "name": "Svobodny 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": false, "country": { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" }, "description": "Svobodny was a Russian rocket launch site located approximately 15 km north of Svobodny, Amur Oblast. The cosmodrome was originally constructed as a launch site for intercontinental ballistic missiles called Svobodny-18. It was initially selected as a replacement for Baikonur Cosmodrome in the Kazakh Soviet Socialist Republic, which became independent as Kazakhstan after the dissolution of the Soviet Union. However the development of Svobodny was subsequently ended in 2007 in favour of a totally new space port, the Vostochny Cosmodrome.", "image": { "id": 2221, "name": "Start-1", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/start-1_image_20240919171507.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/start-1_image_thumbnail_20240919171507.jpeg", "credit": "TASS/Vladimir Sayapin", "license": { "id": 32, "name": "TASS Image Use Policy", "priority": 6, "link": "https://tass.com/terms-of-use" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_146_20200803142450.jpg", "longitude": 128.0, "latitude": 51.7, "timezone_name": "Asia/Yakutsk", "total_launch_count": 5, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 4448, "location_launch_attempt_count": 3, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 13, "orbital_launch_attempt_count_year": 81, "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": "P1076DT22H59M8S", "mission_patches": [] }
