Launch List
AN API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/[id]/ or /launch/?mode=list&search=SpaceX
GET Return a list of all Launch objects.
FILTERS Fields - 'name', 'id(s)', 'lsp__id', 'lsp__name', 'serial_number', 'launcher_config__id', 'rocket__spacecraftflight__spacecraft__name', 'is_crewed', 'include_suborbital', 'spacecraft_config__ids', 'related', 'location__ids', 'lsp__ids', 'pad__ids', 'status__ids'
MODE 'normal', 'list', 'detailed'
EXAMPLE ?mode=list
SEARCH Searches through the launch name, rocket name, launch agency, mission name & spacecraft name.
EXAMPLE - ?search=SpaceX
GET /2.2.0/launch/?format=api&offset=7740&ordering=last_updated
{ "count": 7743, "next": null, "previous": "https://ll.thespacedevs.com/2.2.0/launch/?format=api&limit=10&offset=7730&ordering=last_updated", "results": [ { "id": "7f0892f9-fbc5-4b17-92b0-199277bf75fc", "url": "https://ll.thespacedevs.com/2.2.0/launch/7f0892f9-fbc5-4b17-92b0-199277bf75fc/?format=api", "slug": "vega-c-formosat-9b", "name": "Vega-C | FORMOSAT-9B", "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2025-12-25T09:46:55Z", "net": "2030-12-31T00:00:00Z", "window_end": "2030-12-31T00:00:00Z", "window_start": "2030-12-31T00:00:00Z", "net_precision": { "id": 14, "name": "Year", "abbrev": "Y", "description": "The T-0 is expected in the given year." }, "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 159, "url": "https://ll.thespacedevs.com/2.2.0/agencies/159/?format=api", "name": "Avio S.p.A", "type": "Commercial" }, "rocket": { "id": 8867, "configuration": { "id": 127, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/127/?format=api", "name": "Vega-C", "family": "Vega", "full_name": "Vega-C", "variant": "" } }, "mission": { "id": 7458, "name": "FORMOSAT-9B", "description": "X-band SAR Earth observation satellite.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [ { "id": 1104, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1104/?format=api", "name": "Taiwan Space Agency", "featured": false, "type": "Government", "country_code": "TWN", "abbrev": "TASA", "description": "The Taiwan Space Agency (abbreviated TASA), formerly the National Space Organization (NSPO) from 1991 to 2023, is the national civilian space agency of Taiwan, under the auspices of the National Science and Technology Council. TASA is involved in the development of space technologies and related research.", "administrator": "Director General: Wu Jong-shinn", "founding_year": "1991", "launchers": "", "spacecraft": "", "launch_library_url": 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, "info_url": "https://www.tasa.org.tw/", "wiki_url": "https://en.wikipedia.org/wiki/Taiwan_Space_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tasa_logo_image_20251225090444.png", "image_url": null, "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tasa_social_log_image_20251225090419.jpg" } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 34, "url": "https://ll.thespacedevs.com/2.2.0/pad/34/?format=api", "agency_id": 115, "name": "Ariane Launch Area 1 (ELV)", "description": "ELA-1, now named Ensemble de Lancement Vega (short ELV), is a launch pad at the Centre Spatial Guyanais in French Guiana. It has been used to support launches of the Europa rocket, Ariane 1, Ariane 3, and is currently used to launch Vega rockets.", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/ELA-1", "map_url": "https://www.google.com/maps?q=5.236,-52.775", "latitude": "5.236", "longitude": "-52.775", "location": { "id": 13, "url": "https://ll.thespacedevs.com/2.2.0/location/13/?format=api", "name": "Guiana Space Centre, French Guiana", "country_code": "GUF", "description": "The Guiana Space Centre is a European spaceport to the northwest of Kourou in French Guiana, a region of France in South America. Kourou is located at a latitude of 5°. In operation since 1968, it is a suitable location for a spaceport because of its equatorial location and open sea to the east.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "timezone_name": "America/Cayenne", "total_launch_count": 330, "total_landing_count": 0 }, "country_code": "GUF", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_34_20200803143527.jpg", "total_launch_count": 54, "orbital_launch_attempt_count": 54 }, "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vega-c_image_20220713154437.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7507, "location_launch_attempt_count": 376, "pad_launch_attempt_count": 78, "agency_launch_attempt_count": 22, "orbital_launch_attempt_count_year": 4, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2, "type": "normal" }, { "id": "b7c38b80-6ce7-4ab0-8010-19ee11e26fc5", "url": "https://ll.thespacedevs.com/2.2.0/launch/b7c38b80-6ce7-4ab0-8010-19ee11e26fc5/?format=api", "slug": "smart-dragon-3-unknown-payload", "name": "Smart Dragon 3 | Unknown Payload", "status": { "id": 1, "name": "Go for Launch", "abbrev": "Go", "description": "Current T-0 confirmed by official or reliable sources." }, "last_updated": "2025-12-25T13:26:12Z", "net": "2025-12-29T06:30:00Z", "window_end": "2025-12-29T07:07:00Z", "window_start": "2025-12-29T06:06:00Z", "net_precision": { "id": 2, "name": "Hour", "abbrev": "HR", "description": "The T-0 is accurate to the hour." }, "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 272, "url": "https://ll.thespacedevs.com/2.2.0/agencies/272/?format=api", "name": "China Rocket Co. Ltd.", "type": "Commercial" }, "rocket": { "id": 8861, "configuration": { "id": 484, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/484/?format=api", "name": "Smart Dragon 3", "family": "Smart Dragon", "full_name": "Smart Dragon 3", "variant": "" } }, "mission": { "id": 7452, "name": "Unknown Payload", "description": "Possibly an Earth observation satellite for the Pakistan government's SUPARCO, details TBD.", "launch_designator": null, "type": "Unknown", "orbit": { "id": 25, "name": "Unknown", "abbrev": "N/A" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 221, "url": "https://ll.thespacedevs.com/2.2.0/pad/221/?format=api", "agency_id": 88, "name": "Oriental Spaceport mobile launch ship", "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=35.391667%2C119.598667", "latitude": "35.391667", "longitude": "119.598667", "location": { "id": 185, "url": "https://ll.thespacedevs.com/2.2.0/location/185/?format=api", "name": "Haiyang Oriental Spaceport", "country_code": "CHN", "description": "Chinese orbital launch vehicle launches supporting sea port located at Haiyang, Shandong Province, with dedicated piers and rocket/payload processing facilities for Chinese launch vehicles’ sea launches, and (as part of its expansion project) land based launch pads on artificial islands for various test vehicles and launch vehicles of private and government launch services providers.\r\n\r\nIn operation as a remote base of Taiyuan Satellite Launch Center since 2019.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_haiyang_oriental_spaceport_20251128181322.jpg", "timezone_name": "Asia/Shanghai", "total_launch_count": 21, "total_landing_count": 0 }, "country_code": "CHN", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_oriental_spaceport_mobile_launch_ship_20240529085416.jpg", "total_launch_count": 7, "orbital_launch_attempt_count": 7 }, "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/smart_dragon_3__image_20240925074606.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7173, "location_launch_attempt_count": 22, "pad_launch_attempt_count": 8, "agency_launch_attempt_count": 10, "orbital_launch_attempt_count_year": 324, "location_launch_attempt_count_year": 8, "pad_launch_attempt_count_year": 6, "agency_launch_attempt_count_year": 5, "type": "normal" }, { "id": "7b60de1e-7d8a-4213-a2f5-44a01ae21e28", "url": "https://ll.thespacedevs.com/2.2.0/launch/7b60de1e-7d8a-4213-a2f5-44a01ae21e28/?format=api", "slug": "soyuz-21a-obzor-r-no1", "name": "Soyuz 2.1a | Obzor-R No.1", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2025-12-25T20:01:20Z", "net": "2025-12-25T14:11:00Z", "window_end": "2025-12-25T15:00:00Z", "window_start": "2025-12-25T14:00:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "rocket": { "id": 2509, "configuration": { "id": 24, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/24/?format=api", "name": "Soyuz 2.1a", "family": "Soyuz", "full_name": "Soyuz 2.1a", "variant": "" } }, "mission": { "id": 6636, "name": "Obzor-R No.1", "description": "Note: Assignment of payloads to this launch is uncertain.\r\n\r\nThe Russian Obzor-R satellite is a planned X-band radar earth observation satellite designed by TsSKB-Progress.\r\n\r\nIn 2012, the development of the Arkon-2M radar satellite was stopped and instead the development of the Obzor-R was initiated.\r\n\r\nThe satellite features the BRLK X-band Synthetic Aperture Radar as the imaging instrument with a ground resolution of 500 m.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 85, "url": "https://ll.thespacedevs.com/2.2.0/pad/85/?format=api", "agency_id": 163, "name": "43/4 (43R)", "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=62.92883,40.457098", "latitude": "62.92883", "longitude": "40.457098", "location": { "id": 6, "url": "https://ll.thespacedevs.com/2.2.0/location/6/?format=api", "name": "Plesetsk Cosmodrome, Russian Federation", "country_code": "RUS", "description": "Plesetsk Cosmodrome is a Russian spaceport located in Mirny, Arkhangelsk Oblast, about 800 km north of Moscow and approximately 200 km south of Arkhangelsk. Originally developed as an ICBM site for the R-7 missile, it also served for numerous satellite launches using the R-7 and other rockets. Its high latitude makes it useful only for certain types of launches, especially the Molniya orbits, so for much of the site's history it functioned as a secondary location, with most orbital launches taking place from Baikonur, in the Kazakh SSR. With the end of the Soviet Union, Baikonur became a foreign territory, and Kazakhstan charged $115 million usage fees annually. Consequently, Plesetsk has seen considerably more activity since the 2000s.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_6_20200803142434.jpg", "timezone_name": "Europe/Moscow", "total_launch_count": 1680, "total_landing_count": 0 }, "country_code": "RUS", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_85_20200803143554.jpg", "total_launch_count": 325, "orbital_launch_attempt_count": 325 }, "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1a_image_20230805184309.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7168, "location_launch_attempt_count": 1680, "pad_launch_attempt_count": 325, "agency_launch_attempt_count": 337, "orbital_launch_attempt_count_year": 319, "location_launch_attempt_count_year": 9, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 8, "type": "normal" } ] }
