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/f7dce879-b3ff-40dd-aa23-0c1162ab203d/?format=api
{ "id": "f7dce879-b3ff-40dd-aa23-0c1162ab203d", "url": "https://ll.thespacedevs.com/2.2.0/launch/f7dce879-b3ff-40dd-aa23-0c1162ab203d/?format=api", "slug": "soyuz-21bfregat-meteor-m-no2-1-rideshare-payloads", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz 2.1b/Fregat | Meteor-M No.2-1 & rideshare payloads", "status": { "id": 4, "name": "Launch Failure", "abbrev": "Failure", "description": "Either the launch vehicle did not reach orbit, or the payload(s) failed to separate." }, "last_updated": "2023-06-14T04:09:18Z", "updates": [], "net": "2017-11-28T05:41:46Z", "net_precision": null, "window_end": "2017-11-28T05:41:46Z", "window_start": "2017-11-28T05:41:46Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "An algorithm glitch caused the Fregat upper stage to de-orbit.", "hashtag": null, "launch_service_provider": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "featured": true, "type": "Government", "country_code": "RUS", "abbrev": "RFSA", "description": "The Roscosmos State Corporation for Space Activities, commonly known as Roscosmos, is the governmental body responsible for the space science program of the Russian Federation and general aerospace research. Soyuz has many launch locations the Russian sites are Baikonur, Plesetsk and Vostochny however Ariane also purchases the vehicle and launches it from French Guiana.", "administrator": "Administrator: Yuri Borisov", "founding_year": "1992", "launchers": "Soyuz", "spacecraft": "Soyuz", "launch_library_url": null, "total_launch_count": 331, "consecutive_successful_launches": 55, "successful_launches": 320, "failed_launches": 11, "pending_launches": 4, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://en.roscosmos.ru/", "wiki_url": "http://en.wikipedia.org/wiki/Russian_Federal_Space_Agency", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_nation_20230531052758.jpg" }, "rocket": { "id": 2049, "configuration": { "id": 42, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/42/?format=api", "name": "Soyuz 2.1b/Fregat", "active": true, "reusable": false, "description": "Soyuz-2, GRAU index 14A14, is the collective designation for 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 first-stage boosters and two core stages feature uprated engines with improved injection systems, compared to the previous versions of the Soyuz. Digital flight control and telemetry systems allow the rocket to be launched from a fixed launch platform, whereas the launch platforms for earlier Soyuz rockets had to be rotated as the rocket could not perform a roll to change its heading in flight.\r\n\r\nThe Soyuz 2.1b represents the latest development stage of the proven rocket.\r\n\r\nIt uses the new RD-0124 engines in the first three stages, coupled with an improved injection system that significantly boosts the performance of the Soyuz.\r\nFurthermore, she wears a new, digital startup control system.\r\nThis will allow the Soyuz 2.1b to carry around 1.2 tonnes more payload into low earth orbit compared to its predecessor.", "family": "Soyuz", "full_name": "Soyuz 2.1b Fregat", "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": "Fregat", "alias": "", "min_stage": 3, "max_stage": 4, "length": 46.3, "diameter": 2.95, "maiden_flight": "2006-12-27", "launch_cost": "80000000", "launch_mass": 312, "leo_capacity": 8200, "gto_capacity": 3250, "to_thrust": 4150, "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": "https://en.wikipedia.org/wiki/Soyuz-2", "total_launch_count": 24, "consecutive_successful_launches": 8, "successful_launches": 22, "failed_launches": 2, "pending_launches": 2, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": null }, "mission": { "id": 463, "name": "Meteor-M No.2-1 & rideshare payloads", "description": "This is the third spacecraft in the Russian Meteor-M series of remote sensing satellites. Weighing about 2750 kg, it is intended to gather hydrometeorological data from sun-synchronous orbit. This includes monitoring ozone layer and radiation levels in the near-Earth space, as well as monitoring ocean surface temperatures and ice conditions.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 17, "name": "Sun-Synchronous Orbit", "abbrev": "SSO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 83, "url": "https://ll.thespacedevs.com/2.2.0/pad/83/?format=api", "agency_id": 63, "name": "Cosmodrome Site 1S", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Vostochny_Cosmodrome", "map_url": "https://www.google.com/maps?q=51.884395,128.333932", "latitude": "51.884395", "longitude": "128.333932", "location": { "id": 18, "url": "https://ll.thespacedevs.com/2.2.0/location/18/?format=api", "name": "Vostochny Cosmodrome, Siberia, Russian Federation", "country_code": "RUS", "description": "The Vostochny Cosmodrome is a Russian spaceport above the 51st parallel north in the Amur Oblast, in the Russian Far East. It is intended to reduce Russia's dependency on the Baikonur Cosmodrome in Kazakhstan. The first launch took place on 28 April 2016 at 02:01 UTC.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_18_20200803142401.jpg", "timezone_name": "Asia/Yakutsk", "total_launch_count": 19, "total_landing_count": 0 }, "country_code": "RUS", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_83_20200803143544.jpg", "total_launch_count": 18, "orbital_launch_attempt_count": 18 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Пуск РКН «Союз-2.1б» с КА «Метеор-М» № 2-1(сборник HD)", "description": "28 ноября 2017 года в 08:41 мск с первого гражданского космодрома Восточный успешно стартовала ракета космического назначения в составе ракеты-носителя «Союз...", "feature_image": "https://i.ytimg.com/vi/lB8yZvVLaD0/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=lB8yZvVLaD0", "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": 5695, "location_launch_attempt_count": 2, "pad_launch_attempt_count": 2, "agency_launch_attempt_count": 269, "orbital_launch_attempt_count_year": 80, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 8, "pad_turnaround": "P579DT3H40M25S", "mission_patches": [], "type": "detailed" }
