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/458e2e52-87b0-4707-96d8-6899f92e53ee/?format=api
{ "id": "458e2e52-87b0-4707-96d8-6899f92e53ee", "url": "https://ll.thespacedevs.com/2.0.0/launch/458e2e52-87b0-4707-96d8-6899f92e53ee/?format=api", "launch_library_id": null, "slug": "soyuz-21bfregat-glonass-k1-no-19", "name": "Soyuz 2.1b/Fregat | Glonass-K1 No. 19", "status": { "id": 2, "name": "TBD" }, "net": "2025-12-31T00:00:00Z", "window_end": "2025-12-31T00:00:00Z", "window_start": "2025-12-31T00:00:00Z", "inhold": false, "tbdtime": true, "tbddate": true, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 193, "url": "https://ll.thespacedevs.com/2.0.0/agencies/193/?format=api", "name": "Russian Space Forces", "featured": false, "type": "Government", "country_code": "RUS", "abbrev": "VKS", "description": "The Russian Space Forces are a branch of the Russian Aerospace Forces, that provides aerospace warning, air sovereignty, and protection for Russia. Having been reestablished following August 1, 2015 merger between the Russian Air Force and the Russian Aerospace Defence Forces after a 2011 dissolving of the branch. The Russian Space Forces were originally formed on August 10, 1992 and the creation of the Russian Armed Forces.", "administrator": "Commander: Aleksandr Golovko", "founding_year": "1992", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 143, "consecutive_successful_launches": 55, "successful_launches": 135, "failed_launches": 8, "pending_launches": 2, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Russian_Aerospace_Forces", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520space2520forces_logo_20200805185824.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520space2520forces_image_20191210085547.png", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520space2520forces_nation_20230805154528.png" }, "rocket": { "id": 8148, "configuration": { "id": 42, "launch_library_id": 65, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/42/?format=api", "name": "Soyuz 2.1b/Fregat", "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.\r\n\r\nThe Soyuz 2.1b represents the latest development stage of the proven rocket.\r\n\r\nIt uses the new RD-0124 engines in the first three stages, coupled with an improved injection system that significantly boosts the performance of the Soyuz.\r\nFurthermore, she wears a new, digital startup control system.\r\nThis will allow the Soyuz 2.1b to carry around 1.2 tonnes more payload into low earth orbit compared to its predecessor.", "family": "Soyuz", "full_name": "Soyuz 2.1b Fregat", "manufacturer": { "id": 111, "url": "https://ll.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-prod.nyc3.digitaloceanspaces.com/media/images/progress2520rocket2520space2520center_logo_20210313175054.png", "image_url": null, "nation_url": null }, "program": [], "variant": "Fregat", "alias": "", "min_stage": 3, "max_stage": 4, "length": 46.3, "diameter": 2.95, "maiden_flight": "2006-12-27", "launch_mass": 312, "leo_capacity": 8200, "gto_capacity": 3250, "to_thrust": 4150, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.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": 24, "consecutive_successful_launches": 8, "successful_launches": 22, "failed_launches": 2, "pending_launches": 2 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6707, "launch_library_id": null, "name": "Glonass-K1 No. 19", "description": "Glonass-K are the third generation of satellite design for GLONASS satellite navigation system. GLONASS is a Russian space-based navigation system comparable to the similar GPS and Galileo systems. This generation improves on accuracy, power consumption and design life. Each satellite is unpressurized and weighs 935 kg, and has an operational lifetime of 10 years.", "launch_designator": null, "type": "Navigation", "orbit": { "id": 12, "name": "Medium Earth Orbit", "abbrev": "MEO" } }, "pad": { "id": 48, "url": "https://ll.thespacedevs.com/2.0.0/pad/48/?format=api", "agency_id": 163, "name": "Unknown Pad", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Plesetsk_Cosmodrome", "map_url": "https://www.google.com/maps?q=62.925556,40.577778", "latitude": "62.925556", "longitude": "40.577778", "location": { "id": 6, "url": "https://ll.thespacedevs.com/2.0.0/location/6/?format=api", "name": "Plesetsk Cosmodrome, Russian Federation", "country_code": "RUS", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_6_20200803142434.jpg", "total_launch_count": 1674, "total_landing_count": 0 }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_48_20200803143459.jpg", "total_launch_count": 0 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 7113, "location_launch_attempt_count": 1677, "pad_launch_attempt_count": 3, "agency_launch_attempt_count": 145, "orbital_launch_attempt_count_year": 264, "location_launch_attempt_count_year": 6, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 4 }
