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/7a643c1d-09be-4599-9926-00b99016a5ac/?format=api
{ "id": "7a643c1d-09be-4599-9926-00b99016a5ac", "url": "https://ll.thespacedevs.com/2.3.0/launches/7a643c1d-09be-4599-9926-00b99016a5ac/?format=api", "name": "Kuaizhou-1A | Shiyan 14 & Shiyan 15", "response_mode": "detailed", "slug": "kuaizhou-1a-shiyan-14-shiyan-15", "launch_designator": "2022-118", "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-12-25T03:46:26Z", "net": "2022-09-24T22:55:00Z", "net_precision": null, "window_end": "2022-09-24T23:04:00Z", "window_start": "2022-09-24T22:42:00Z", "image": { "id": 1758, "name": "[AUTO] Kuaizhou - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/kuaizhou_image_20191027094423.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193703.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "normal", "id": 184, "url": "https://ll.thespacedevs.com/2.3.0/agencies/184/?format=api", "name": "China Aerospace Science and Industry Corporation", "abbrev": "CASIC", "type": { "id": 1, "name": "Government" }, "featured": false, "country": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "description": "The China Aerospace Science & Industry Corporation Limited (CASIC) is a Chinese state-owned corporation that designs, develops and manufactures a range of spacecrafts, launch vehicles, strategic and tactical missile systems, and ground equipment.", "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "parent": null, "image": { "id": 7, "name": "[AUTO] China Aerospace Science and Industry Corporation - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china_aerospace_image_20201111143053.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184555.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 123, "name": "[AUTO] China Aerospace Science and Industry Corporation - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520industry2520corporation_logo_20201111180047.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184932.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 49, "name": "[AUTO] China Aerospace Science and Industry Corporation - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520aerospace2520science2520and2520industry2520corporation_nation_20200912142919.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184744.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 5, "consecutive_successful_launches": 5, "successful_launches": 5, "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": "http://english.casic.cn/", "wiki_url": "https://en.wikipedia.org/wiki/China_Aerospace_Science_and_Industry_Corporation", "social_media_links": [] }, "rocket": { "id": 7643, "configuration": { "response_mode": "detailed", "id": 135, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/135/?format=api", "name": "Kuaizhou", "families": [ { "response_mode": "detailed", "id": 100, "name": "Kuaizhou", "manufacturer": [ { "response_mode": "normal", "id": 194, "url": "https://ll.thespacedevs.com/2.3.0/agencies/194/?format=api", "name": "ExPace", "abbrev": "EP", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "description": "ExPace is a Chinese space rocket company based in Wuhan, Hubei, China. It is a wholly owned subsidiary of missileer China Aerospace Science and Industry Corporation (CASIC), a Chinese state-owned company, and serves as its commercial rocket division. ExPace is focused on small satellite launchers to low Earth orbit.", "administrator": "CEO: Zhang Di", "founding_year": 2016, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": { "id": 57, "name": "[AUTO] ExPace - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/expace_nation_20230608044150.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184756.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 29, "consecutive_successful_launches": 0, "successful_launches": 25, "failed_launches": 4, "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/ExPace", "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "2017-01-09", "total_launch_count": 34, "consecutive_successful_launches": 0, "successful_launches": 30, "failed_launches": 4, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Kuaizhou-1A", "variant": "1A", "active": true, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 194, "url": "https://ll.thespacedevs.com/2.3.0/agencies/194/?format=api", "name": "ExPace", "abbrev": "EP", "type": { "id": 3, "name": "Commercial" }, "featured": false, "country": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "description": "ExPace is a Chinese space rocket company based in Wuhan, Hubei, China. It is a wholly owned subsidiary of missileer China Aerospace Science and Industry Corporation (CASIC), a Chinese state-owned company, and serves as its commercial rocket division. ExPace is focused on small satellite launchers to low Earth orbit.", "administrator": "CEO: Zhang Di", "founding_year": 2016, "launchers": "", "spacecraft": "", "parent": null, "image": null, "logo": null, "social_logo": { "id": 57, "name": "[AUTO] ExPace - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/expace_nation_20230608044150.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184756.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 29, "consecutive_successful_launches": 0, "successful_launches": 25, "failed_launches": 4, "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/ExPace", "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 1758, "name": "[AUTO] Kuaizhou - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/kuaizhou_image_20191027094423.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193703.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/Kuaizhou", "description": "Kuaizhou is a family of Chinese \"quick-reaction\" orbital launch vehicles. Flying since 2013, Kuaizhou 1 and 1A consist of three solid-fueled rocket stages, with a liquid-fueled fourth stage as part of the satellite system.", "alias": "", "min_stage": 4, "max_stage": 4, "length": 19.4, "diameter": 1.4, "maiden_flight": "2017-01-09", "launch_cost": null, "launch_mass": 30.0, "leo_capacity": 300.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": 250.0, "to_thrust": null, "apogee": null, "total_launch_count": 29, "consecutive_successful_launches": 0, "successful_launches": 26, "failed_launches": 3, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "PT5H56M14S" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 6146, "name": "Shiyan 14 & Shiyan 15", "type": "Government/Top Secret", "description": "2 Chinese classified satellites.", "image": null, "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 158, "url": "https://ll.thespacedevs.com/2.3.0/pads/158/?format=api", "active": true, "agencies": [], "name": "Mobile Launcher Pad", "image": null, "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Taiyuan_Satellite_Launch_Center", "map_url": "https://www.google.com/maps?q=38.890002,111.608129", "latitude": 38.890002, "longitude": 111.608129, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_158_20200803143440.jpg", "total_launch_count": 2, "orbital_launch_attempt_count": 2, "fastest_turnaround": "P1022DT19H59M14S", "location": { "response_mode": "normal", "id": 19, "url": "https://ll.thespacedevs.com/2.3.0/locations/19/?format=api", "name": "Taiyuan Satellite Launch Center, People's Republic of China", "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": 7161, "successful_launches": 6618, "failed_launches": 543, "total_attempted_landings": 1110, "successful_landings": 1067, "failed_landings": 43 }, "active": true, "country": { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" }, "description": "The Taiyuan Satellite Launch Center is a People's Republic of China space and defense launch facility. It is situated in Kelan County, Xinzhou, Shanxi Province and is the second of four launch sites having been founded in March 1966 and coming into full operation in 1968.", "image": { "id": 1369, "name": "[AUTO] Long March 2D | 6 x Jilin-1, Qilu-2/3 & others - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20230907134308.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192538.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_19_20200803142421.jpg", "longitude": 111.608, "latitude": 38.8491, "timezone_name": "Asia/Shanghai", "total_launch_count": 141, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 6304, "location_launch_attempt_count": 110, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 5, "orbital_launch_attempt_count_year": 122, "location_launch_attempt_count_year": 9, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 2, "flightclub_url": null, "updates": [ { "id": 2474, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success", "info_url": "https://m.weibo.cn/detail/4817487924037531", "created_by": "Cosmic_Penguin", "created_on": "2022-09-24T23:37:50Z" }, { "id": 2455, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch per NOTAMs; launch vehicle and payload very uncertain.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=57128.msg2410708#msg2410708", "created_by": "Cosmic_Penguin", "created_on": "2022-09-22T01:20:13Z" } ], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P1022DT19H59M14S", "mission_patches": [] }
