Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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'
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.0.0/launch/43cfdc96-8481-446f-ace5-ddc5ed60fb14/?format=api
{ "id": "43cfdc96-8481-446f-ace5-ddc5ed60fb14", "url": "https://lldev.thespacedevs.com/2.0.0/launch/43cfdc96-8481-446f-ace5-ddc5ed60fb14/?format=api", "launch_library_id": null, "slug": "soyuz-21bfregat-m-aist-2t-01-02", "name": "Soyuz 2.1b/Fregat-M | AIST-2T 01 & 02", "status": { "id": 3, "name": "Success" }, "net": "2025-12-28T13:18:05Z", "window_end": "2025-12-28T13:18:05Z", "window_start": "2025-12-28T13:18:05Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 63, "url": "https://lldev.thespacedevs.com/2.0.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-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": 8364, "configuration": { "id": 134, "launch_library_id": 153, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/134/?format=api", "name": "Soyuz 2.1b/Fregat-M", "description": "Soyuz-2, GRAU index 14A14, is the collective designation for 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 first-stage boosters and two core stages feature uprated engines with improved injection systems, compared to the previous versions of the Soyuz. Digital flight control and telemetry systems allow the rocket to be launched from a fixed launch platform, whereas the launch platforms for earlier Soyuz rockets had to be rotated as the rocket could not perform a roll to change its heading in flight.", "family": "Soyuz", "full_name": "Soyuz 2.1b Fregat-M", "manufacturer": { "id": 111, "url": "https://lldev.thespacedevs.com/2.0.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": "Fregat-M", "alias": "", "min_stage": 4, "max_stage": 4, "length": 46.3, "diameter": 10.3, "maiden_flight": "2008-07-26", "launch_mass": 313, "leo_capacity": 8200, "gto_capacity": 3250, "to_thrust": 4150, "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": "https://en.wikipedia.org/wiki/Soyuz-2", "total_launch_count": 34, "consecutive_successful_launches": 34, "successful_launches": 34, "failed_launches": 0, "pending_launches": 2 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6945, "launch_library_id": null, "name": "AIST-2T 01 & 02", "description": "A pair of Russian optical Earth observation satellites built by the Progress Rocket Space Centre for obtaining stereo images of the Earth's surface, with maximum resolution of 1.2 m in panchromatic mode and a swath width of 32 km.\r\n\r\n50 small satellites will also be launched as ride-share payloads, including 3 from Iran.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" } }, "pad": { "id": 83, "url": "https://lldev.thespacedevs.com/2.0.0/pad/83/?format=api", "agency_id": 63, "name": "Cosmodrome Site 1S", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vostochny_Cosmodrome", "map_url": "https://www.google.com/maps?q=51.884395,128.333932", "latitude": "51.884395", "longitude": "128.333932", "location": { "id": 18, "url": "https://lldev.thespacedevs.com/2.0.0/location/18/?format=api", "name": "Vostochny Cosmodrome, Siberia, Russian Federation", "country_code": "RUS", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_18_20200803142401.jpg", "total_launch_count": 21, "total_landing_count": 0 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_83_20200803143544.jpg", "total_launch_count": 20 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "title": "Трансляция запуска космических аппаратов «Аист-2Т» с космодрома Восточный", "description": "28 декабря с космодрома Восточный в 16:18 мск запланирован пуск ракеты «Союз-2.1б» со спутниками «Аист-2Т» № 1 и № 2 и иными космическими аппаратами. \n\nСпутники, запущенные сегодня с Восточного, предназначены для дистанционного зондирования Земли,\nизучения электромагнитных излучений,\nконтроля судоходства в Мировом океане,\nполучения сигналов передатчиков «Интернета вещей», исследований влияния космоса на живые организмы.\n\n\nСайт Роскосмоса: https://www.roscosmos.ru/\nРоскосмос в социальных сетях: \nVk: https://vk.com/roscosmos\nOk: https://ok.ru/roscosmos \nTelegram: https://t.me/roscosmos_gk \nRutube: https://rutube.ru/channel/770606/\n\nНовый telegram-канал о путешествиях на космодромы: https://t.me/cosmotours\n\n#Роскосмос #РоскосмосТВ", "feature_image": "https://i.ytimg.com/vi/lFOWEUSP9Vo/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=lFOWEUSP9Vo" } ], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7171, "location_launch_attempt_count": 21, "pad_launch_attempt_count": 20, "agency_launch_attempt_count": 338, "orbital_launch_attempt_count_year": 322, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 9 }
