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/b8eec19b-3974-4468-a15a-180e5af5071a/?format=api
{ "id": "b8eec19b-3974-4468-a15a-180e5af5071a", "url": "https://lldev.thespacedevs.com/2.0.0/launch/b8eec19b-3974-4468-a15a-180e5af5071a/?format=api", "launch_library_id": null, "slug": "soyuz-21afregat-m-kosmos-unknown-payload", "name": "Soyuz 2.1a/Fregat-M | Kosmos (Unknown Payload)", "status": { "id": 1, "name": "Go" }, "net": "2025-05-23T07:00:00Z", "window_end": "2025-05-23T09:00:00Z", "window_start": "2025-05-23T07:00:00Z", "inhold": false, "tbdtime": true, "tbddate": false, "probability": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 193, "url": "https://lldev.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": 3, "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": 8618, "configuration": { "id": 45, "launch_library_id": 83, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/45/?format=api", "name": "Soyuz 2.1a/Fregat-M", "description": "The 2.1a version includes conversion from analog to digital flight control system and uprated engines on the booster and the first stage with improved injection systems. The new digital flight control and telemetry systems allow the rocket to launch from a fixed rather than angled launch platform and adjust its heading in flight. A digital control system also enables the launch of larger commercial satellites with wider and longer payload fairings such as the ST-type fairing. These fairings introduce too much aerodynamic instability for the old analog system to handle.", "family": "Soyuz", "full_name": "Soyuz 2.1a 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-prod.nyc3.digitaloceanspaces.com/media/images/progress2520rocket2520space2520center_logo_20210313175054.png", "image_url": null, "nation_url": null }, "program": [], "variant": "Fregat-M", "alias": "", "min_stage": 3, "max_stage": 3, "length": 46.3, "diameter": 2.95, "maiden_flight": "2010-10-19", "launch_mass": 312, "leo_capacity": 7020, "gto_capacity": null, "to_thrust": 4149, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1a_image_20190726062341.png", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2", "total_launch_count": 19, "consecutive_successful_launches": 9, "successful_launches": 18, "failed_launches": 1, "pending_launches": 1 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 7210, "launch_library_id": null, "name": "Kosmos (Unknown Payload)", "description": "Unknown classified payload for the Russian military.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 25, "name": "Unknown", "abbrev": "N/A" } }, "pad": { "id": 48, "url": "https://lldev.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://lldev.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/soyuz25202.1a_image_20190726062341.png", "infographic": null, "program": [], "orbital_launch_attempt_count": 6963, "location_launch_attempt_count": 1675, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 144, "orbital_launch_attempt_count_year": 114, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 3 }
