Launch List
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/?format=api&offset=7500&ordering=-id
{ "count": 7502, "next": null, "previous": "https://ll.thespacedevs.com/2.3.0/launches/?format=api&limit=10&offset=7490&ordering=-id", "results": [ { "id": "00190507-4918-491a-aa73-0e151775fada", "url": "https://ll.thespacedevs.com/2.3.0/launches/00190507-4918-491a-aa73-0e151775fada/?format=api", "name": "Long March 2D | Xihe (CHASE)", "response_mode": "normal", "slug": "long-march-2d-xihe-chase", "launch_designator": "2021-091", "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-14T03:42:39Z", "net": "2021-10-14T10:51:00Z", "net_precision": null, "window_end": "2021-10-14T11:12:00Z", "window_start": "2021-10-14T10:44:00Z", "image": { "id": 1768, "name": "[AUTO] Long March 2D - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/long2520march25202d_image_20190222031211.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193719.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": "list", "id": 88, "url": "https://ll.thespacedevs.com/2.3.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "abbrev": "CASC", "type": { "id": 1, "name": "Government" } }, "rocket": { "id": 2717, "configuration": { "response_mode": "list", "id": 17, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/17/?format=api", "name": "Long March 2D", "families": [ { "response_mode": "list", "id": 106, "name": "Long March" }, { "response_mode": "list", "id": 109, "name": "Long March 2" } ], "full_name": "Long March 2D", "variant": "2D" } }, "mission": { "id": 5875, "name": "Xihe (CHASE)", "type": "Heliophysics", "description": "Xihe, also known as the Chinese Hα Solar Explorer (CHASE), is designed to test a newly developed satellite platform and conduct solar observations. The scientific payload of the satellite is an Hα imaging spectrograph (HIS), which can, for the first time, acquire full-disk spectroscopic solar observations in the Hα waveband. It will complement the observations by on-orbit solar spacecraft (such as SDO, IRIS, STEREO and PSP), as well as future solar missions of the Solar Orbiter and the Chinese Advanced Space-based Solar Observatory (ASO-S).\r\nMission is named Xihe after a solar deity from Chinese mythology.", "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": 25, "url": "https://ll.thespacedevs.com/2.3.0/pads/25/?format=api", "active": true, "agencies": [], "name": "Launch Complex 9", "image": { "id": 2125, "name": "CZ-4B liftoff from LC-9 (Gaofen-11-05)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cz-4b_liftoff__image_20240719064703.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cz-4b_liftoff__image_thumbnail_20240719064704.jpeg", "credit": "中国航天科技集团", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": false, "variants": [] }, "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=38.863128,111.589567", "latitude": 38.863128, "longitude": 111.589567, "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_25_20200803143501.jpg", "total_launch_count": 76, "orbital_launch_attempt_count": 76, "fastest_turnaround": "P16DT20H3M", "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": 7150, "successful_launches": 6607, "failed_launches": 543, "total_attempted_landings": 1104, "successful_landings": 1061, "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": 140, "total_landing_count": 0 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 6135, "location_launch_attempt_count": 98, "pad_launch_attempt_count": 54, "agency_launch_attempt_count": 338, "orbital_launch_attempt_count_year": 98, "location_launch_attempt_count_year": 9, "pad_launch_attempt_count_year": 6, "agency_launch_attempt_count_year": 34 }, { "id": "000fbb81-80c8-4095-a811-aa561ce9ed3c", "url": "https://ll.thespacedevs.com/2.3.0/launches/000fbb81-80c8-4095-a811-aa561ce9ed3c/?format=api", "name": "Delta IV Heavy | NROL-26 (USA-202)", "response_mode": "normal", "slug": "delta-iv-heavy-nrol-26-usa-202", "launch_designator": "2009-001", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-03-13T10:23:31Z", "net": "2009-01-18T02:47:00Z", "net_precision": null, "window_end": "2009-01-18T02:47:00Z", "window_start": "2009-01-18T02:47:00Z", "image": { "id": 2006, "name": "Delta IV Heavy liftoff from LC-37 (NROL-26)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta_iv_heavy__image_20240313102319.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/delta_iv_heavy__image_thumbnail_20240313102319.jpeg", "credit": "United Launch Alliance", "license": { "id": 10, "name": "ULA Image Use Policy", "priority": 3, "link": "https://www.ulalaunch.com/terms-and-conditions" }, "single_use": true, "variants": [] }, "infographic": null, "probability": 0, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "response_mode": "list", "id": 124, "url": "https://ll.thespacedevs.com/2.3.0/agencies/124/?format=api", "name": "United Launch Alliance", "abbrev": "ULA", "type": { "id": 3, "name": "Commercial" } }, "rocket": { "id": 1407, "configuration": { "response_mode": "list", "id": 21, "url": "https://ll.thespacedevs.com/2.3.0/launcher_configurations/21/?format=api", "name": "Delta IV Heavy", "families": [ { "response_mode": "list", "id": 72, "name": "Delta" }, { "response_mode": "list", "id": 175, "name": "Delta IV" } ], "full_name": "Delta IV Heavy", "variant": "Heavy" } }, "mission": { "id": 553, "name": "NROL-26 (USA-202)", "type": "Government/Top Secret", "description": "A military reconnaissance satellite, it's purpose is classified.", "image": null, "orbit": { "id": 2, "name": "Geostationary Transfer Orbit", "abbrev": "GTO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 38, "url": "https://ll.thespacedevs.com/2.3.0/pads/38/?format=api", "active": true, "agencies": [], "name": "Space Launch Complex 37B", "image": { "id": 2032, "name": "SLC-37B", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/slc-37b_image_20240329083424.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/slc-37b_image_thumbnail_20240329083424.jpeg", "credit": "United Launch Alliance", "license": { "id": 10, "name": "ULA Image Use Policy", "priority": 3, "link": "https://www.ulalaunch.com/terms-and-conditions" }, "single_use": true, "variants": [] }, "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Space_Launch_Complex_37", "map_url": "https://www.google.com/maps?q=28.5317,-80.56495", "latitude": 28.5317, "longitude": -80.56495, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_38_20200803143515.jpg", "total_launch_count": 40, "orbital_launch_attempt_count": 40, "fastest_turnaround": "P66DT5H24M59S", "location": { "response_mode": "normal", "id": 12, "url": "https://ll.thespacedevs.com/2.3.0/locations/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "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": 7150, "successful_launches": 6607, "failed_launches": 543, "total_attempted_landings": 1104, "successful_landings": 1061, "failed_landings": 43 }, "active": true, "country": { "id": 2, "name": "United States of America", "alpha_2_code": "US", "alpha_3_code": "USA", "nationality_name": "American", "nationality_name_composed": "Americano" }, "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.", "image": { "id": 2200, "name": "Cape Canaveral & KSC seen from orbit (STS-43)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_20240918151615.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cape_canaveral__image_thumbnail_20240918151616.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": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "longitude": -80.577778, "latitude": 28.488889, "timezone_name": "America/New_York", "total_launch_count": 1021, "total_landing_count": 64 } }, "webcast_live": false, "program": [], "orbital_launch_attempt_count": 4955, "location_launch_attempt_count": 658, "pad_launch_attempt_count": 14, "agency_launch_attempt_count": 23, "orbital_launch_attempt_count_year": 1, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1 } ] }
