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/04941f7c-a19e-4fce-9716-59336efe56ba/?format=api
{ "id": "04941f7c-a19e-4fce-9716-59336efe56ba", "url": "https://ll.thespacedevs.com/2.3.0/launches/04941f7c-a19e-4fce-9716-59336efe56ba/?format=api", "name": "Start-1 | EROS B", "response_mode": "detailed", "slug": "start-1-eros-b", "launch_designator": "2006-014", "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": "2006-04-25T16:47:16Z", "net_precision": null, "window_end": "2006-04-25T16:47:16Z", "window_start": "2006-04-25T16:47:16Z", "image": null, "infographic": null, "probability": null, "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": 7263, "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": 5652, "name": "EROS B", "type": "Earth Science", "description": "In order to address market demand for faster revisit of EROS (Earth Resources Observation Systems B) satellites, ImageSat has purchased the EROS B satellite, which is scheduled for launch during the first quarter of 2006. Similar in appearance to EROS A, the new satellite has superior capabilities, including a larger camera of CCD/TDI type (Charge Coupled Device/Time Delay Integration), with standard panchromatic resolution of 0.70 m at an altitude of about 500 km, a larger on-board recorder, improved pointing accuracy and a faster data communication link.", "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": 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": 4766, "location_launch_attempt_count": 5, "pad_launch_attempt_count": 5, "agency_launch_attempt_count": 63, "orbital_launch_attempt_count_year": 16, "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": "P1890DT7H58M49S", "mission_patches": [] }
