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/808bb3d2-2142-4916-9326-7b488ce9e0cd/?format=api
{ "id": "808bb3d2-2142-4916-9326-7b488ce9e0cd", "url": "https://ll.thespacedevs.com/2.2.0/launch/808bb3d2-2142-4916-9326-7b488ce9e0cd/?format=api", "slug": "soyuz-2-1b-lotos-s-kosmos-2502", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz 2-1B | Lotos-S (Kosmos 2502)", "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:00Z", "updates": [], "net": "2014-12-25T03:01:13Z", "net_precision": null, "window_end": "2014-12-25T03:01:13Z", "window_start": "2014-12-25T03:01:13Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": null, "hashtag": null, "launch_service_provider": { "id": 163, "url": "https://ll.thespacedevs.com/2.2.0/agencies/163/?format=api", "name": "Russian Aerospace Defence Forces", "featured": false, "type": "Government", "country_code": "RUS", "abbrev": "VKO", "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 22, "consecutive_successful_launches": 17, "successful_launches": 20, "failed_launches": 2, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.eng.mil.ru/en/structure/forces/cosmic.htm", "wiki_url": "http://en.wikipedia.org/wiki/Russian_Aerospace_Defence_Forces", "logo_url": null, "image_url": null, "nation_url": null }, "rocket": { "id": 1815, "configuration": { "id": 15, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/15/?format=api", "name": "Soyuz 2.1b", "active": true, "reusable": false, "description": "Soyuz-2 is the 21st-century version of the Russian Soyuz rocket. In its basic form, it is a three-stage carrier rocket for placing payloads into low Earth orbit. The 2.1b version adds an upgraded engine (RD-0124) with improved performance to the second stage.", "family": "Soyuz", "full_name": "Soyuz 2.1b", "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": "2008-07-26", "launch_cost": "80000000", "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_2.1b_image_20230802085331.jpg", "info_url": null, "wiki_url": "http://en.wikipedia.org/wiki/Soyuz-2_(rocket)", "total_launch_count": 21, "consecutive_successful_launches": 21, "successful_launches": 21, "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": null, "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": 0, "source": null, "publisher": null, "title": "Launch of Russian Soyuz 2.1b rocket carrying Lotos-S ELINT spy sat from Plesetsk", "description": "Launch of Russian Soyuz 2.1b rocket carrying Lotos-S ELINT spy sat Dec. 24 at 10:01 pm EST", "feature_image": "https://i.ytimg.com/vi/KfijAaAFT9E/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=KfijAaAFT9E", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5438, "location_launch_attempt_count": 1603, "pad_launch_attempt_count": 279, "agency_launch_attempt_count": 18, "orbital_launch_attempt_count_year": 5438, "location_launch_attempt_count_year": 10, "pad_launch_attempt_count_year": 6, "agency_launch_attempt_count_year": 8, "pad_turnaround": "P24DT5H8M47S", "mission_patches": [], "type": "detailed" }
