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/49678ae6-8664-4d60-9aa2-622c087ed917/?format=api
{ "id": "49678ae6-8664-4d60-9aa2-622c087ed917", "url": "https://lldev.thespacedevs.com/2.2.0/launch/49678ae6-8664-4d60-9aa2-622c087ed917/?format=api", "slug": "soyuz-21b-bion-m-no-2", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz 2.1b | Bion-M No. 2", "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-08-26T11:54:02Z", "updates": [ { "id": 11507, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET August 20.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=26990.msg2700462#msg2700462", "created_by": "Cosmic_Penguin", "created_on": "2025-07-11T13:17:00Z" }, { "id": 11842, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Setting GO.", "info_url": "https://tass.ru/kosmos/24705757", "created_by": "Cosmic_Penguin", "created_on": "2025-08-12T02:04:00Z" }, { "id": 10923, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET July 20.", "info_url": "https://kosmodrom.space/raspisanie-zapuskov", "created_by": "Cosmic_Penguin", "created_on": "2025-05-08T08:21:00Z" }, { "id": 9992, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET July.", "info_url": "https://kosmodrom.space/raspisanie-zapuskov", "created_by": "Cosmic_Penguin", "created_on": "2025-02-03T18:30:00Z" }, { "id": 11238, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET August 25.", "info_url": "https://forum.novosti-kosmonavtiki.ru/index.php?msg=2733497", "created_by": "Cosmic_Penguin", "created_on": "2025-06-10T12:07:00Z" }, { "id": 11914, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Tweaked T-0.", "info_url": "https://rg.ru/2025/08/19/ot-zakrytiia-biona-m-2-do-kontakta-podema-dolzhno-projti-ne-bolee-72-chasov.html", "created_by": "Cosmic_Penguin", "created_on": "2025-08-19T17:53:00Z" }, { "id": 11917, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/ll2_profile_20230311134739.png", "comment": "Official Webcast by Роскосмос ТВ has started", "info_url": "https://www.youtube.com/watch?v=2w1THKyWX2g", "created_by": "LL2", "created_on": "2025-08-20T16:11:00Z" }, { "id": 9641, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET March 25.", "info_url": "https://kosmodrom.space/raspisanie-zapuskov", "created_by": "Cosmic_Penguin", "created_on": "2024-12-26T17:55:00Z" }, { "id": 10983, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch time.", "info_url": "https://drive.google.com/file/d/1wmfOiEaJayZQLBhjh2qjxqRUM0j8e143/view", "created_by": "Cosmic_Penguin", "created_on": "2025-05-14T17:02:00Z" }, { "id": 11919, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff.", "info_url": "https://www.youtube.com/watch?v=2w1THKyWX2g", "created_by": "Cosmic_Penguin", "created_on": "2025-08-20T17:13:00Z" }, { "id": 11920, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Spacecraft separation.", "info_url": "https://www.youtube.com/watch?v=2w1THKyWX2g", "created_by": "Cosmic_Penguin", "created_on": "2025-08-20T17:26:00Z" }, { "id": 11925, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch success.", "info_url": "https://t.me/roscosmos_gk/18052", "created_by": "Cosmic_Penguin", "created_on": "2025-08-20T23:31:00Z" }, { "id": 8749, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET March 2025.", "info_url": "https://x.com/katlinegrey/status/1841471508390027456", "created_by": "Cosmic_Penguin", "created_on": "2024-10-02T16:37:00Z" }, { "id": 5590, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch.", "info_url": "https://tass.ru/kosmos/19179563", "created_by": "Cosmic_Penguin", "created_on": "2023-11-02T13:35:05Z" }, { "id": 7226, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET September 1st.", "info_url": "https://tass.ru/kosmos/20477371", "created_by": "Cosmic_Penguin", "created_on": "2024-04-08T13:18:21Z" }, { "id": 7980, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET TBD 2024.", "info_url": "https://kosmodrom.space/raspisanie-zapuskov", "created_by": "Cosmic_Penguin", "created_on": "2024-06-30T19:15:05Z" }, { "id": 8385, "profile_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "NET 2025.", "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:36:15Z" } ], "net": "2025-08-20T17:13:10Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2025-08-20T17:13:10Z", "window_start": "2025-08-20T17:13:10Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 63, "url": "https://lldev.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": 340, "consecutive_successful_launches": 64, "successful_launches": 329, "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-dev.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_nation_20230531052758.jpg" }, "rocket": { "id": 8083, "configuration": { "id": 15, "url": "https://lldev.thespacedevs.com/2.2.0/config/launcher/15/?format=api", "name": "Soyuz 2.1b", "active": true, "reusable": false, "description": "Soyuz-2 is the 21st-century version of the Russian Soyuz rocket. In its basic form, it is a three-stage carrier rocket for placing payloads into low Earth orbit. The 2.1b version adds an upgraded engine (RD-0124) with improved performance to the second stage.", "family": "Soyuz", "full_name": "Soyuz 2.1b", "manufacturer": { "id": 111, "url": "https://lldev.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-dev.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": "2008-07-26", "launch_cost": "80000000", "launch_mass": 312, "leo_capacity": 8200, "gto_capacity": 3250, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg", "info_url": null, "wiki_url": "http://en.wikipedia.org/wiki/Soyuz-2_(rocket)", "total_launch_count": 23, "consecutive_successful_launches": 23, "successful_launches": 23, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6637, "name": "Bion-M No. 2", "description": "Bion-M is the next generation of Russian biological research satellites. While retaining the Vostok/Zenit-derived reentry module of the earlier Bion, the propulsion module has been replace by a Yantar type module, which provides maneuvering capabilities and longer mission support. The mission duration has been increased to up to 6 months by using solar cells for energy generation. The weight of scientific equipment has been increased by 100 kilograms.", "launch_designator": null, "type": "Biology", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 20, "url": "https://lldev.thespacedevs.com/2.2.0/pad/20/?format=api", "agency_id": null, "name": "31/6", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Baikonur_Cosmodrome_Site_31", "map_url": "https://www.google.com/maps?q=45.996034,63.564003", "latitude": "45.996034", "longitude": "63.564003", "location": { "id": 15, "url": "https://lldev.thespacedevs.com/2.2.0/location/15/?format=api", "name": "Baikonur Cosmodrome, Republic of Kazakhstan", "country_code": "KAZ", "description": "The Baikonur Cosmodrome is a spaceport operated by Russia within Kazakhstan. Located in the Kazakh city of Baikonur, it is the largest operational space launch facility in terms of area. All Russian crewed spaceflights are launched from Baikonur.", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_15_20200803142517.jpg", "timezone_name": "Asia/Qyzylorda", "total_launch_count": 1561, "total_landing_count": 0 }, "country_code": "KAZ", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_20_20200803143516.jpg", "total_launch_count": 427, "orbital_launch_attempt_count": 427 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "Роскосмос ТВ", "title": "Трансляция запуска спутника «Бион-М» № 2", "description": "20 августа запланирован запуск «Биона-М» № 2 — большой медико-биологической лаборатории.\n\nГлавная цель этого запуска — вывод на околополярную орбиту исследовательского аппарата «Бион-М» № 2 . В спутни...", "feature_image": "https://i.ytimg.com/vi/2w1THKyWX2g/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=2w1THKyWX2g", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 3, "name": "Russian", "code": "ru" }, "start_time": "2025-08-20T16:11:01Z", "end_time": "2025-08-20T21:37:54Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7036, "location_launch_attempt_count": 1557, "pad_launch_attempt_count": 424, "agency_launch_attempt_count": 334, "orbital_launch_attempt_count_year": 187, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P47DT21H40M30S", "mission_patches": [], "type": "detailed" }
