Launch Instance
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/7b60de1e-7d8a-4213-a2f5-44a01ae21e28/?format=api
{ "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", "flightclub_url": null, "r_spacex_api_id": null, "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-26T15:54:25Z", "updates": [ { "id": 13469, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://mil.ru/ministry/structure/structuremorf/ec89e8c6-9037-4ef5-b01a-d140d7f4969d", "created_by": "Cosmic_Penguin", "created_on": "2025-12-25T20:01:00Z" }, { "id": 13468, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff.", "info_url": "https://tass.ru/armiya-i-opk/26019965", "created_by": "Cosmic_Penguin", "created_on": "2025-12-25T14:37:00Z" }, { "id": 13459, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Tweaked T-0.", "info_url": "https://forum.novosti-kosmonavtiki.ru/index.php?msg=2800009", "created_by": "Cosmic_Penguin", "created_on": "2025-12-24T17:42:00Z" }, { "id": 13457, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Apparently scrubbed for the day due to launch site strong winds; next attempt tomorrow.", "info_url": "https://forum.novosti-kosmonavtiki.ru/index.php?msg=2799997", "created_by": "Cosmic_Penguin", "created_on": "2025-12-24T15:39:00Z" }, { "id": 13410, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET December 24.", "info_url": "https://forum.novosti-kosmonavtiki.ru/index.php?msg=2798334", "created_by": "Cosmic_Penguin", "created_on": "2025-12-19T21:14:00Z" }, { "id": 13335, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Rescheduled for NET December 23 per NOTAMs.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=32725.msg2743402#msg2743402", "created_by": "Cosmic_Penguin", "created_on": "2025-12-15T16:14:00Z" }, { "id": 13221, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Reverted back to NET 2025 TBD with cancellation of NOTAMs and marine navigation warnings.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=63982.msg2741727#msg2741727", "created_by": "Cosmic_Penguin", "created_on": "2025-12-09T23:29:00Z" }, { "id": 13141, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET December 11 per NOTAMs; Assignment of payloads to this launch is uncertain.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=63982.msg2739759#msg2739759", "created_by": "Cosmic_Penguin", "created_on": "2025-12-04T22:11:00Z" }, { "id": 10300, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET summer-fall 2025.", "info_url": "https://forum.novosti-kosmonavtiki.ru/index.php?msg=2703187", "created_by": "Cosmic_Penguin", "created_on": "2025-03-06T06:50:00Z" }, { "id": 8983, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Q1 2025.", "info_url": "https://tass.ru/kosmos/22210273", "created_by": "Cosmic_Penguin", "created_on": "2024-10-24T12:21:00Z" }, { "id": 8384, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Q4 2024.", "info_url": "https://prokosmos.ru/2024/08/21/gendirektor-rkts-progress-eksperimenti-na-bione-m-pomogut-v-poletakh-lyudei-na-lunu-i-mars", "created_by": "Cosmic_Penguin", "created_on": "2024-08-24T12:35:34Z" }, { "id": 6455, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Q2 2024.", "info_url": "https://www.roscosmos.ru/40124/", "created_by": "Cosmic_Penguin", "created_on": "2024-01-23T23:42:42Z" }, { "id": 5637, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Q1 2024.", "info_url": "https://www.vedomosti.ru/technology/articles/2023/10/10/999695-roskosmos-hochet-prodavat-sputnikovie-snimki", "created_by": "Cosmic_Penguin", "created_on": "2023-11-08T16:30:55Z" }, { "id": 3674, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET Late 2023.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=26990.msg2469692#msg2469692", "created_by": "Cosmic_Penguin", "created_on": "2023-03-26T07:53:46Z" } ], "net": "2025-12-25T14:11:00Z", "net_precision": { "id": 1, "name": "Minute", "abbrev": "MIN", "description": "The T-0 is accurate to the minute." }, "window_end": "2025-12-25T15:00:00Z", "window_start": "2025-12-25T14:00:00Z", "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)", "featured": true, "type": "Government", "country_code": "RUS", "abbrev": "RFSA", "description": "The Roscosmos State Corporation for Space Activities, commonly known as Roscosmos, is the governmental body responsible for the space science program of the Russian Federation and general aerospace research. Soyuz has many launch locations the Russian sites are Baikonur, Plesetsk and Vostochny however Ariane also purchases the vehicle and launches it from French Guiana.", "administrator": "Administrator: Yuri Borisov", "founding_year": "1992", "launchers": "Soyuz", "spacecraft": "Soyuz", "launch_library_url": null, "total_launch_count": 338, "consecutive_successful_launches": 62, "successful_launches": 327, "failed_launches": 11, "pending_launches": 2, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://en.roscosmos.ru/", "wiki_url": "https://en.wikipedia.org/wiki/Russian_Federal_Space_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_nation_20230531052758.jpg" }, "rocket": { "id": 2509, "configuration": { "id": 24, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/24/?format=api", "name": "Soyuz 2.1a", "active": true, "reusable": false, "description": "The Soyuz 2.1A converted the flight control system from analog to digital, which allowed launch from fixed platforms. It also allowed big fairings and payloads.\r\nIt is currently used for crewed Soyuz and Progress flights to the ISS.", "family": "Soyuz", "full_name": "Soyuz 2.1a", "manufacturer": { "id": 111, "url": "https://ll.thespacedevs.com/2.2.0/agencies/111/?format=api", "name": "Progress Rocket Space Center", "featured": false, "type": "Commercial", "country_code": "RUS", "abbrev": "PRSC", "description": "Progress Rocket Space Centre, formerly known as TsSKB-Progress, is a space science and aerospace research company which is known for manufacturing launch vehicles and satellites. Most notably, Progress Rocket Space Centre is the manufacturer of Soyuz launch vehicles.", "administrator": "CEO: Dmitry Baranov", "founding_year": "1996", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 45, "consecutive_successful_launches": 3, "successful_launches": 44, "failed_launches": 1, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://en.samspace.ru/", "wiki_url": "https://en.wikipedia.org/wiki/Progress_Rocket_Space_Centre", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/progress2520rocket2520space2520center_logo_20210313175054.png", "image_url": null, "nation_url": null }, "program": [], "variant": "", "alias": "", "min_stage": 2, "max_stage": 3, "length": 46.3, "diameter": 2.95, "maiden_flight": "2004-11-04", "launch_cost": "80000000", "launch_mass": 312, "leo_capacity": 7020, "gto_capacity": 2810, "to_thrust": 4149, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1a_image_20230805184309.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2#Soyuz-2.1a", "total_launch_count": 55, "consecutive_successful_launches": 48, "successful_launches": 54, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "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 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "The Space Devs", "title": "Russian Federal Space Agency (ROSCOSMOS) Obzor-R No.1", "description": "On Thursday December 25, 2025, Russian Federal Space Agency (ROSCOSMOS) launched the Obzor-R No.1 mission with a Soyuz 2.1a from 43/4 (43R) at Plesetsk Cosmodrome, Russian Federation.\n\nDescription generated from the Launch Library 2 API.\n——————————————————————\nObject in the Launch Library 2 API: https://ll.thespacedevs.com/2.3.0/launches/7b60de1e-7d8a-4213-a2f5-44a01ae21e28/\nRelated news in the Spaceflight News API: https://api.spaceflightnewsapi.net/v4/articles/?launch=7b60de1e-7d8a-4213-a2f5-44a01ae21e28\n——————————————————————\n\nRehosted on YouTube by The Space Devs.\nSupport our work on https://www.patreon.com/TheSpaceDevs\n——————————————————————\nWebsite: https://thespacedevs.com\nX: https://x.com/thespacedevs\nDiscord: https://discord.com/invite/p7ntkNA\n——————————————————————\n\nOriginal...", "feature_image": "https://i.ytimg.com/vi/WhXEbrvtaiM/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=WhXEbrvtaiM", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2025-12-26T15:54:16Z", "end_time": "2025-12-26T15:54:55Z" } ], "webcast_live": false, "timeline": [], "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, "pad_turnaround": "P216DT5H35M", "mission_patches": [], "type": "detailed" }
