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/2ac5dd6f-d79e-4566-bd5a-355f9bde01cb/?format=api
{ "id": "2ac5dd6f-d79e-4566-bd5a-355f9bde01cb", "url": "https://ll.thespacedevs.com/2.2.0/launch/2ac5dd6f-d79e-4566-bd5a-355f9bde01cb/?format=api", "slug": "soyuz-21vvolga-aist-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz 2.1v/Volga | Aist-1", "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:11Z", "updates": [], "net": "2013-12-28T12:30:00Z", "net_precision": null, "window_end": "2013-12-28T12:30:00Z", "window_start": "2013-12-28T12:30:00Z", "probability": null, "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": "https://www.eng.mil.ru/en/structure/forces/cosmic.htm", "wiki_url": "https://en.wikipedia.org/wiki/Russian_Aerospace_Defence_Forces", "logo_url": null, "image_url": null, "nation_url": null }, "rocket": { "id": 1731, "configuration": { "id": 60, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/60/?format=api", "name": "Soyuz 2.1v", "active": false, "reusable": false, "description": "The Soyuz-2.1v is a Russian expendable carrier rocket. It was derived from the Soyuz-2.1b, and is a member of the R-7 family of rockets.", "family": "Soyuz", "full_name": "Soyuz 2.1v Volga", "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": "Volga", "alias": "", "min_stage": 2, "max_stage": 2, "length": 44.0, "diameter": 3.0, "maiden_flight": "2013-12-28", "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/soyuz25202-1v_image_20191122081651.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz_2.1v", "total_launch_count": 9, "consecutive_successful_launches": 7, "successful_launches": 8, "failed_launches": 1, "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": 1685, "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": 328, "orbital_launch_attempt_count": 328 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": "youtube.com", "publisher": "Lee Cremer", "title": "LIFTOFF of the new Soyuz-2.1v core rocket from Plesetsk carrying AIST", "description": "Russian TV video - LIFTOFF the new Soyuz-2.1v core rocket from Plesetsk carrying AIST satellite Dec. 28 at 12:30 UTC", "feature_image": "https://i.ytimg.com/vi/__4PLtcQRug/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=__4PLtcQRug", "type": { "id": 6, "name": "Recap" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2013-12-29T00:24:12Z", "end_time": "2013-12-29T00:24:44Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202-1v_image_20191122081651.jpg", "infographic": null, "program": [], "orbital_launch_attempt_count": 5349, "location_launch_attempt_count": 1593, "pad_launch_attempt_count": 273, "agency_launch_attempt_count": 10, "orbital_launch_attempt_count_year": 81, "location_launch_attempt_count_year": 7, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 6, "pad_turnaround": "P203DT17H52M1S", "mission_patches": [], "type": "detailed" }