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/7b60de1e-7d8a-4213-a2f5-44a01ae21e28/?format=api
{ "id": "7b60de1e-7d8a-4213-a2f5-44a01ae21e28", "url": "https://ll.thespacedevs.com/2.0.0/launch/7b60de1e-7d8a-4213-a2f5-44a01ae21e28/?format=api", "launch_library_id": 1954, "slug": "soyuz-21a-obzor-r-no1", "name": "Soyuz 2.1a | Obzor-R No.1", "status": { "id": 2, "name": "TBD" }, "net": "2025-09-30T00:00:00Z", "window_end": "2025-09-30T00:00:00Z", "window_start": "2025-09-30T00:00:00Z", "inhold": false, "tbdtime": true, "tbddate": true, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 63, "url": "https://ll.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": 331, "consecutive_successful_launches": 55, "successful_launches": 320, "failed_launches": 11, "pending_launches": 10, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://en.roscosmos.ru/", "wiki_url": "http://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, "launch_library_id": 49, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/24/?format=api", "name": "Soyuz 2.1a", "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.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": "", "alias": "", "min_stage": 2, "max_stage": 3, "length": 46.3, "diameter": 2.95, "maiden_flight": "2004-11-04", "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": 51, "consecutive_successful_launches": 44, "successful_launches": 50, "failed_launches": 1, "pending_launches": 6 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6636, "launch_library_id": null, "name": "Obzor-R No.1", "description": "The 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" } }, "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.1a_image_20230805184309.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6995, "location_launch_attempt_count": 1675, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 337, "orbital_launch_attempt_count_year": 146, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 8 }
