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/e1140531-122d-4062-a5a5-194042674121/?format=api
{ "id": "e1140531-122d-4062-a5a5-194042674121", "url": "https://ll.thespacedevs.com/2.2.0/launch/e1140531-122d-4062-a5a5-194042674121/?format=api", "slug": "soyuz-21v-razbeg-1-kosmos-2551", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz 2.1v | Razbeg 1 (Kosmos 2551)", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2023-06-14T04:11:07Z", "updates": [ { "id": 678, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "Launch time now TBD.", "info_url": "https://twitter.com/Nextlaunch/status/1419230733076467712?s=19", "created_by": "Cosmic_Penguin", "created_on": "2021-07-25T14:09:02Z" }, { "id": 675, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/spacevogel_profile_20210217192809.jpg", "comment": "Added launch based on insider report which is confirmed by multiple NOTAMs.", "info_url": "https://forum.novosti-kosmonavtiki.ru/index.php?topic=16307.msg2230172#msg2230172", "created_by": "spacevogel", "created_on": "2021-07-24T11:01:36Z" }, { "id": 808, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/swgustav_profile_20210218062738.jpg", "comment": "Launch is successful at 19:59 UTC", "info_url": "https://twitter.com/roscosmos/status/1436061717302321154", "created_by": "SwGustav", "created_on": "2021-09-09T21:00:29Z" }, { "id": 792, "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/profile_images/cosmic2520penguin_profile_20210817212020.png", "comment": "New launch time.", "info_url": "https://twitter.com/Nextlaunch/status/1434010810037178368?s=19", "created_by": "Cosmic_Penguin", "created_on": "2021-09-04T07:53:30Z" } ], "net": "2021-09-09T19:59:47Z", "net_precision": null, "window_end": "2021-09-09T21:00:00Z", "window_start": "2021-09-09T19: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": 144, "consecutive_successful_launches": 56, "successful_launches": 136, "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": 2972, "configuration": { "id": 153, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/153/?format=api", "name": "Soyuz", "active": false, "reusable": false, "description": "", "family": "Soyuz", "full_name": "Soyuz 2.1v", "manufacturer": { "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 }, "program": [], "variant": "2.1v", "alias": "", "min_stage": 2, "max_stage": 2, "length": 44.0, "diameter": 3.0, "maiden_flight": "2018-03-29", "launch_cost": null, "launch_mass": 158, "leo_capacity": 2850, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_image_20190222031122.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz_2.1v", "total_launch_count": 4, "consecutive_successful_launches": 4, "successful_launches": 4, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 1400, "name": "Razbeg 1 (Kosmos 2551)", "description": "The Russian Razbeg 1 is small military satellite optical reconnaissance satellite.\r\n\r\nIt was built by NPP VNIIEM. It is likely the same satellite identified in earlier reports as Zvesda. The 250 kg satellite was reportedly inspired by the US American commercial Earth imaging satellites of the SkySat 1 series. It features a camera built by the Belarusian company OAO Peleng with a maximum ground resolution of 0.9 meters in panchromatic mode.", "launch_designator": null, "type": "Government/Top Secret", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "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": 1675, "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": 324, "orbital_launch_attempt_count": 324 }, "infoURLs": [], "vidURLs": [ { "priority": 10, "source": null, "publisher": null, "title": "Пуск ракеты носителя «Союз 2» с космодрома Плесецк", "description": "Все предстартовые операции и старт ракеты «Союз-2.1В» прошли в штатном режиме. Средства наземного автоматизированного комплекса управления космическими аппар...", "feature_image": "https://i.ytimg.com/vi/9DvKnSfKCEI/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=9DvKnSfKCEI", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_image_20190222031122.jpeg", "infographic": null, "program": [], "orbital_launch_attempt_count": 6125, "location_launch_attempt_count": 1644, "pad_launch_attempt_count": 306, "agency_launch_attempt_count": 118, "orbital_launch_attempt_count_year": 88, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 3, "pad_turnaround": "P76DT9M47S", "mission_patches": [], "type": "detailed" }
