Launch Instance
AN API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/[id]/ or /launch/?mode=list&search=SpaceX
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', 'is_crewed', 'include_suborbital', 'spacecraft_config__ids', 'related', 'location__ids', 'lsp__ids', 'pad__ids', 'status__ids'
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.2.0/launch/95a9c95c-1a30-4b34-8b11-16e765a26eb6/?format=api
{ "id": "95a9c95c-1a30-4b34-8b11-16e765a26eb6", "url": "https://ll.thespacedevs.com/2.2.0/launch/95a9c95c-1a30-4b34-8b11-16e765a26eb6/?format=api", "slug": "soyuz-21a-kosmos-2579-bars-m-no-6", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz 2.1a | Kosmos 2579 (Bars-M No. 6)", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-10-31T20:29:04Z", "updates": [ { "id": 9048, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch successful and payload in contact.", "info_url": "https://tass.ru/armiya-i-opk/22280125", "created_by": "Cosmic_Penguin", "created_on": "2024-10-31T10:57:00Z" }, { "id": 9047, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Liftoff confirmed.", "info_url": "https://tass.ru/kosmos/22277959", "created_by": "Cosmic_Penguin", "created_on": "2024-10-31T08:14:00Z" }, { "id": 9007, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Added launch; Payload identity and Soyuz vehicle variant not confirmed.", "info_url": "https://forum.nasaspaceflight.com/index.php?topic=61767.msg2636230#msg2636230", "created_by": "Cosmic_Penguin", "created_on": "2024-10-26T04:18:00Z" } ], "net": "2024-10-31T07:51:31Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "2024-10-31T09:00:00Z", "window_start": "2024-10-31T07:00:00Z", "probability": null, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 193, "url": "https://ll.thespacedevs.com/2.2.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": 8395, "configuration": { "id": 24, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/24/?format=api", "name": "Soyuz 2.1a", "active": true, "reusable": false, "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.2.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_cost": "80000000", "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": 1, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 6980, "name": "Kosmos 2579 (Bars-M No. 6)", "description": "Note: Payload identity uncertain. \r\n\r\nBars-M is the second incarnation of the Bars project, which was started in the mid 1990ies to develop a successor for the Komtea class of area surveillance satellites. The original Bars project was halted in the early 2000s. In 2007, TsSKB-Progress was contracted for Bars-M, for which reportedly the Yantar-based service module was replaced by a new developed advanced service module.\r\n\r\nThe Bars-M satellites feature an electro-optical camera system called Karat, which is developed and built by the Leningrad Optical Mechanical Association (LOMO), and a dual laser altimeter instrument to deliver topographic imagery, stereo images, altimeter data and high-resolution images with a ground resolution around 1 meter.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [ { "id": 175, "url": "https://ll.thespacedevs.com/2.2.0/agencies/175/?format=api", "name": "Ministry of Defence of the Russian Federation", "featured": false, "type": "Government", "country_code": "RUS", "abbrev": "MOD_RUS", "description": "The Ministry of Defence of the Russian Federation is the governing body of the Russian Armed Forces.", "administrator": "Minister: Gen. Sergey Shoygu", "founding_year": "1717", "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 0, "consecutive_successful_launches": 0, "successful_launches": 0, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.mil.ru", "wiki_url": "https://en.wikipedia.org/wiki/Ministry_of_Defence_(Russia)", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ministry2520of2520defence2520of2520the2520russian2520federation_logo_20210905134213.png", "image_url": null, "nation_url": null } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 85, "url": "https://ll.thespacedevs.com/2.2.0/pad/85/?format=api", "agency_id": 163, "name": "43/4 (43R)", "description": "", "info_url": null, "wiki_url": null, "map_url": "https://www.google.com/maps?q=62.92883,40.457098", "latitude": "62.92883", "longitude": "40.457098", "location": { "id": 6, "url": "https://ll.thespacedevs.com/2.2.0/location/6/?format=api", "name": "Plesetsk Cosmodrome, Russian Federation", "country_code": "RUS", "description": "Plesetsk Cosmodrome is a Russian spaceport located in Mirny, Arkhangelsk Oblast, about 800 km north of Moscow and approximately 200 km south of Arkhangelsk. Originally developed as an ICBM site for the R-7 missile, it also served for numerous satellite launches using the R-7 and other rockets. Its high latitude makes it useful only for certain types of launches, especially the Molniya orbits, so for much of the site's history it functioned as a secondary location, with most orbital launches taking place from Baikonur, in the Kazakh SSR. With the end of the Soviet Union, Baikonur became a foreign territory, and Kazakhstan charged $115 million usage fees annually. Consequently, Plesetsk has seen considerably more activity since the 2000s.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_6_20200803142434.jpg", "timezone_name": "Europe/Moscow", "total_launch_count": 1674, "total_landing_count": 0 }, "country_code": "RUS", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_85_20200803143554.jpg", "total_launch_count": 323, "orbital_launch_attempt_count": 323 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "The Space Devs", "title": "Russian Space Forces Kosmos 2579 (Bars-M No. 6)", "description": "On Thursday October 31, 2024, Russian Space Forces launched the Kosmos 2579 (Bars-M No. 6) mission with a Soyuz 2.1a from 43/4 (43R) at Plesetsk Cosmodrome, Russian Federation.Description generated fr...", "feature_image": "https://i.ytimg.com/vi/Fp9610u-IUI/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=Fp9610u-IUI", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2024-10-31T20:27:14Z", "end_time": "2024-10-31T20:30:52Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1a_image_20230805184309.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6790, "location_launch_attempt_count": 1670, "pad_launch_attempt_count": 321, "agency_launch_attempt_count": 140, "orbital_launch_attempt_count_year": 201, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 3, "pad_turnaround": "P167DT10H29M52S", "mission_patches": [], "type": "detailed" }
