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/2ac49b3d-a02b-4e78-ac8e-1a585d5be00b/?format=api
{ "id": "2ac49b3d-a02b-4e78-ac8e-1a585d5be00b", "url": "https://ll.thespacedevs.com/2.0.0/launch/2ac49b3d-a02b-4e78-ac8e-1a585d5be00b/?format=api", "launch_library_id": 312, "slug": "soyuz-stbfregat-galileo-l3-foc-fm01-fm02", "name": "Soyuz STB/Fregat | Galileo L3 (FOC FM01-FM02)", "status": { "id": 7, "name": "Partial Failure" }, "net": "2014-08-22T12:27:11Z", "window_end": "2014-08-22T12:27:11Z", "window_start": "2014-08-22T12:27:11Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": null, "holdreason": "", "failreason": "Satellites were placed into an incorrect orbit due to an anomaly with the Fregat upper stage. Both payloads recovered using their own propulsion.", "hashtag": null, "launch_service_provider": { "id": 115, "url": "https://ll.thespacedevs.com/2.0.0/agencies/115/?format=api", "name": "Arianespace", "featured": true, "type": "Commercial", "country_code": "FRA", "abbrev": "ASA", "description": "Arianespace SA is a multinational company founded in 1980 as the world's first commercial launch service provider. It undertakes the production, operation, and marketing of the Ariane programme. Their vehicles launch exclusively from French Guiana in South America.", "administrator": "CEO: David Cavaillolès", "founding_year": "1980", "launchers": "Ariane | Vega", "spacecraft": "", "launch_library_url": null, "total_launch_count": 327, "consecutive_successful_launches": 15, "successful_launches": 312, "failed_launches": 15, "pending_launches": 28, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.arianespace.com", "wiki_url": "https://en.wikipedia.org/wiki/Arianespace", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_logo_20210603173752.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ariane_64_lifto_image_20260213070745.jpg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/arianespace_nation_20230530190314.jpg" }, "rocket": { "id": 1780, "configuration": { "id": 171, "launch_library_id": 52, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/171/?format=api", "name": "Soyuz STB", "description": "The 2.1b version adds an upgraded engine (RD-0124) with improved performance to the second stage. First launch took place from Plesetsk Cosmodrome Site 43 on 26 July 2008 with a classified military payload.\r\n\r\nThe 2.1b/ST version is sometimes called Soyuz ST-B.", "family": "Soyuz", "full_name": "Soyuz STB 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": "STB/Fregat", "alias": "", "min_stage": 3, "max_stage": 3, "length": 46.3, "diameter": 2.95, "maiden_flight": "2011-10-21", "launch_mass": 312, "leo_capacity": 8200, "gto_capacity": 3250, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_stb_image_20211130181029.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-2_(rocket)", "total_launch_count": 14, "consecutive_successful_launches": 11, "successful_launches": 13, "failed_launches": 1, "pending_launches": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 33, "launch_library_id": 50, "name": "Galileo L3 (FOC FM01-FM02)", "description": "These are the first two Full Operational Capability satellites of the Galileo constellation, ESA's satellite navigation system and is expected to be completed by 2020. Galileo will provide Europe with an alternative to the American GPS and Russian GLONASS constellations, but will be interoperable with both systems.", "launch_designator": null, "type": "Navigation", "orbit": { "id": 12, "name": "Medium Earth Orbit", "abbrev": "MEO" } }, "pad": { "id": 81, "url": "https://ll.thespacedevs.com/2.0.0/pad/81/?format=api", "agency_id": 115, "name": "Soyuz Launch Complex", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Ensemble_de_Lancement_Soyouz", "map_url": "https://www.google.com/maps?q=5.3019,-52.8346", "latitude": "5.3019", "longitude": "-52.8346", "location": { "id": 13, "url": "https://ll.thespacedevs.com/2.0.0/location/13/?format=api", "name": "Guiana Space Centre, French Guiana", "country_code": "GUF", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_13_20200803142412.jpg", "total_launch_count": 334, "total_landing_count": 0 }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_81_20200803143601.jpg", "total_launch_count": 26 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "title": "Galileo liftoff replay", "description": "On 22 August, at 12:27 GMT/14:27 CEST, a Soyuz rocket launched Europe’s fifth and six Galileo satellites from Europe's Spaceport in Kourou, French Guiana. Rewatch the moment of launch here.\n\nThese new...", "feature_image": "https://i.ytimg.com/vi/4mQZUPEpYfM/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=4mQZUPEpYfM" } ], "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_stb_image_20211130181029.jpeg", "infographic": null, "program": [ { "id": 30, "url": "https://ll.thespacedevs.com/2.0.0/program/30/?format=api", "name": "Galileo", "description": "Galileo is a global navigation satellite system (GNSS) that went live in 2016, created by the European Union through the European Space Agency (ESA), operated by the European Union Agency for the Space Programme (EUSPA).", "agencies": [ { "id": 27, "url": "https://ll.thespacedevs.com/2.0.0/agencies/27/?format=api", "name": "European Space Agency", "type": "Multinational" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/galileo_program_20231230110547.png", "start_date": "2011-10-21T10:30:00Z", "end_date": null, "info_url": "https://www.gsc-europa.eu/", "wiki_url": "https://en.wikipedia.org/wiki/Galileo_(satellite_navigation)" } ], "orbital_launch_attempt_count": 5401, "location_launch_attempt_count": 239, "pad_launch_attempt_count": 9, "agency_launch_attempt_count": 224, "orbital_launch_attempt_count_year": 52, "location_launch_attempt_count_year": 7, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 7 }
