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/93bd93e5-4f5c-4730-b65e-11f9770168ca/?format=api
{ "id": "93bd93e5-4f5c-4730-b65e-11f9770168ca", "url": "https://ll.thespacedevs.com/2.3.0/launches/93bd93e5-4f5c-4730-b65e-11f9770168ca/?format=api", "name": "Ceres-1 | Tianqi-11", "response_mode": "detailed", "slug": "ceres-1-tianqi-11", "launch_designator": "2020-080", "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-07-08T08:42:03Z", "net": "2020-11-07T07:12:00Z", "net_precision": null, "window_end": "2020-11-07T07:42:00Z", "window_start": "2020-11-07T07:06:00Z", "image": { "id": 1708, "name": "[AUTO] Ceres-1 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ceres-1_image_20230722081939.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193541.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": 1021, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1021/?format=api", "name": "Galactic Energy", "abbrev": "GE", "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": "Galactic Energy is a private aerospace company headquartered in Beijing, China. Established by senior engineers in 2018, Galactic Energy engages in low-cost commercial space launch business.", "administrator": null, "founding_year": 2018, "launchers": "Ceres-1 | Pallas-1", "spacecraft": "", "parent": null, "image": { "id": 11, "name": "[AUTO] Galactic Energy - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galactic_energy_image_20201106095228.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184607.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 135, "name": "[AUTO] Galactic Energy - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_logo_20201106095229.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184957.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 59, "name": "[AUTO] Galactic Energy - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_nation_20230703094321.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184759.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 20, "consecutive_successful_launches": 10, "successful_launches": 19, "failed_launches": 1, "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.galactic-energy.cn/index.php/En", "wiki_url": null, "social_media_links": [] }, "rocket": { "id": 2806, "configuration": { "response_mode": "detailed", "id": 461, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/461/?format=api", "name": "Ceres-1", "families": [ { "response_mode": "detailed", "id": 2, "name": "Ceres-1", "manufacturer": [ { "response_mode": "normal", "id": 1021, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1021/?format=api", "name": "Galactic Energy", "abbrev": "GE", "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": "Galactic Energy is a private aerospace company headquartered in Beijing, China. Established by senior engineers in 2018, Galactic Energy engages in low-cost commercial space launch business.", "administrator": null, "founding_year": 2018, "launchers": "Ceres-1 | Pallas-1", "spacecraft": "", "parent": null, "image": { "id": 11, "name": "[AUTO] Galactic Energy - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galactic_energy_image_20201106095228.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184607.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 135, "name": "[AUTO] Galactic Energy - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_logo_20201106095229.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184957.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 59, "name": "[AUTO] Galactic Energy - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_nation_20230703094321.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184759.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 20, "consecutive_successful_launches": 10, "successful_launches": 19, "failed_launches": 1, "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.galactic-energy.cn/index.php/En", "wiki_url": null, "social_media_links": [] } ], "parent": null, "description": "", "active": true, "maiden_flight": "2020-11-07", "total_launch_count": 19, "consecutive_successful_launches": 9, "successful_launches": 18, "failed_launches": 1, "pending_launches": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 } ], "full_name": "Ceres-1", "variant": "Ceres-1", "active": true, "is_placeholder": false, "manufacturer": { "response_mode": "normal", "id": 1021, "url": "https://ll.thespacedevs.com/2.3.0/agencies/1021/?format=api", "name": "Galactic Energy", "abbrev": "GE", "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": "Galactic Energy is a private aerospace company headquartered in Beijing, China. Established by senior engineers in 2018, Galactic Energy engages in low-cost commercial space launch business.", "administrator": null, "founding_year": 2018, "launchers": "Ceres-1 | Pallas-1", "spacecraft": "", "parent": null, "image": { "id": 11, "name": "[AUTO] Galactic Energy - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galactic_energy_image_20201106095228.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184607.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 135, "name": "[AUTO] Galactic Energy - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_logo_20201106095229.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184957.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 59, "name": "[AUTO] Galactic Energy - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galactic2520energy_nation_20230703094321.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184759.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 20, "consecutive_successful_launches": 10, "successful_launches": 19, "failed_launches": 1, "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.galactic-energy.cn/index.php/En", "wiki_url": null, "social_media_links": [] }, "program": [], "reusable": false, "image": { "id": 1708, "name": "[AUTO] Ceres-1 - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ceres-1_image_20230722081939.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193541.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": "http://www.galactic-energy.cn/index.php/En/List/cid/14", "wiki_url": null, "description": "Ceres-1 is the first solid propellant launch vehicle of Galactic Energy.", "alias": "", "min_stage": 3, "max_stage": 4, "length": null, "diameter": null, "maiden_flight": "2020-11-07", "launch_cost": null, "launch_mass": null, "leo_capacity": 350.0, "gto_capacity": null, "geo_capacity": null, "sso_capacity": 230.0, "to_thrust": 598.0, "apogee": null, "total_launch_count": 15, "consecutive_successful_launches": 6, "successful_launches": 14, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0, "fastest_turnaround": "P4DT3H" }, "launcher_stage": [], "spacecraft_stage": [], "payloads": [] }, "mission": { "id": 1206, "name": "Tianqi-11", "type": "Communications", "description": "Tianqi (also transcribed Tiange) is a series of small Chinese experimental LEO comsats by Guodian Gaoke for IoT (Internet of Things) communications, which are also carrying a camera for educational purposes.\r\n\r\nGuodian Gaoke plans to operate an IoT constellation. The \"Apocalypse Constellation\" provides users with much-needed data collection and transmission services for terrestrial network coverage blind areas, which are widely used in marine, environmental protection, meteorological, forestry, geological, emergency, rescue and smart city industries to enhance China's global data network coverage and application capabilities are of strategic importance.", "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": 21, "url": "https://ll.thespacedevs.com/2.3.0/pads/21/?format=api", "active": true, "agencies": [], "name": "Launch Area 95A", "image": { "id": 1329, "name": "Ceres-1 liftoff from LA-95A (Jilin-1 High Resolution 03D-08, 51 to 54)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ceres-1252025_image_20230703100031.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192423.jpeg", "credit": "Galactic Energy", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Satellite_Launch_Center", "map_url": "https://www.google.com/maps?q=40.969117,100.343333", "latitude": 40.969117, "longitude": 100.343333, "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_21_20200803143253.jpg", "total_launch_count": 59, "orbital_launch_attempt_count": 59, "fastest_turnaround": "P2DT1H47M", "location": { "response_mode": "normal", "id": 17, "url": "https://ll.thespacedevs.com/2.3.0/locations/17/?format=api", "name": "Jiuquan 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": 7162, "successful_launches": 6618, "failed_launches": 544, "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": "Jiuquan Satellite Launch Center is a Chinese spaceport located between the Ejin, Alxa, Inner Mongolia and Hangtian Town, Jinta County, Jiuquan, Gansu Province. It is part of the Dongfeng Aerospace City (Base 10).", "image": { "id": 1374, "name": "Long March 2F/G liftoff (Shenzhou 16)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20240101085213.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192548.jpeg", "credit": "CMS", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg", "longitude": 100.291111, "latitude": 40.958056, "timezone_name": "Asia/Shanghai", "total_launch_count": 250, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 6010, "location_launch_attempt_count": 134, "pad_launch_attempt_count": 21, "agency_launch_attempt_count": 1, "orbital_launch_attempt_count_year": 88, "location_launch_attempt_count_year": 12, "pad_launch_attempt_count_year": 5, "agency_launch_attempt_count_year": 1, "flightclub_url": null, "updates": [], "info_urls": [], "vid_urls": [], "timeline": [], "pad_turnaround": "P56DT2H10M", "mission_patches": [] }
