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/2bd21ce8-cc49-4c1f-b49c-8ccf22b9b813/?format=api
{ "id": "2bd21ce8-cc49-4c1f-b49c-8ccf22b9b813", "url": "https://ll.thespacedevs.com/2.2.0/launch/2bd21ce8-cc49-4c1f-b49c-8ccf22b9b813/?format=api", "slug": "soyuz-u-soyuz-tm-23", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz-U | Soyuz TM-23", "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-14T08:43:50Z", "updates": [], "net": "1996-02-21T12:34:05Z", "net_precision": null, "window_end": "1996-02-21T12:34:05Z", "window_start": "1996-02-21T12:34:05Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": null, "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": 330, "consecutive_successful_launches": 54, "successful_launches": 319, "failed_launches": 11, "pending_launches": 11, "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": 396, "configuration": { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/37/?format=api", "name": "Soyuz U", "active": false, "reusable": false, "description": "", "family": "Soyuz", "full_name": "Soyuz U", "manufacturer": { "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": 330, "consecutive_successful_launches": 54, "successful_launches": 319, "failed_launches": 11, "pending_launches": 11, "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" }, "program": [], "variant": "", "alias": "", "min_stage": 2, "max_stage": 3, "length": 51.1, "diameter": 2.95, "maiden_flight": "1973-05-18", "launch_cost": null, "launch_mass": 313, "leo_capacity": 6900, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz2520u_image_20190222031023.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-U", "total_launch_count": 714, "consecutive_successful_launches": 1, "successful_launches": 694, "failed_launches": 20, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 239, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/239/?format=api", "mission_end": "1996-09-02T07:41:00Z", "destination": "Mir", "launch_crew": [ { "id": 2676, "role": { "id": 1, "role": "Commander", "priority": 0 }, "astronaut": { "id": 215, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/215/?format=api", "name": "Yury Onufriyenko", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P389DT14H46M12S", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "date_of_birth": "1961-02-06", "date_of_death": null, "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Col. Yuri Ivanovich Onufriyenko (Russian: Юрий Иванович Онуфриенко, Ukrainian: Юрій Іванович Онуфрієнко) (born 6 February 1961) is a retired Russian cosmonaut. He is a veteran of two extended spaceflights, aboard the space station Mir in 1996 and aboard the International Space Station in 2001-2002.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/yury2520onufriyenko_image_20181201184528.jpg", "wiki": "https://en.wikipedia.org/wiki/Yury_Onufriyenko", "last_flight": "2001-12-05T22:19:28Z", "first_flight": "1996-02-21T12:34:05Z" } }, { "id": 2681, "role": { "id": 3, "role": "Flight Engineer", "priority": 2 }, "astronaut": { "id": 274, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/274/?format=api", "name": "Yury Usachov", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P552DT22H23M37S", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "date_of_birth": "1957-10-09", "date_of_death": null, "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Yury Vladimirovich Usachov (Russian: Юрий Владимирович Усачёв; born October 9, 1957 in Donetsk, Rostov Oblast, Russia) is a former cosmonaut who resides in Star City, Moscow. Usachov is a veteran of four spaceflights, including two long duration missions on board the Mir Space Station and another on board the International Space Station.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/yury2520usachov_image_20181201223522.jpg", "wiki": "https://en.wikipedia.org/wiki/Yury_Usachov", "last_flight": "2001-03-08T11:42:09Z", "first_flight": "1994-01-08T10:05:34Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 2675, "role": { "id": 1, "role": "Commander", "priority": 0 }, "astronaut": { "id": 215, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/215/?format=api", "name": "Yury Onufriyenko", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P389DT14H46M12S", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "date_of_birth": "1961-02-06", "date_of_death": null, "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Col. Yuri Ivanovich Onufriyenko (Russian: Юрий Иванович Онуфриенко, Ukrainian: Юрій Іванович Онуфрієнко) (born 6 February 1961) is a retired Russian cosmonaut. He is a veteran of two extended spaceflights, aboard the space station Mir in 1996 and aboard the International Space Station in 2001-2002.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/yury2520onufriyenko_image_20181201184528.jpg", "wiki": "https://en.wikipedia.org/wiki/Yury_Onufriyenko", "last_flight": "2001-12-05T22:19:28Z", "first_flight": "1996-02-21T12:34:05Z" } }, { "id": 659, "role": { "id": 11, "role": "Research Cosmonaut", "priority": 2 }, "astronaut": { "id": 120, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/120/?format=api", "name": "Claudie Haigneré", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P25DT14H23M22S", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/agencies/27/?format=api", "name": "European Space Agency", "type": "Multinational" }, "date_of_birth": "1957-05-13", "date_of_death": null, "nationality": "French", "twitter": null, "instagram": null, "bio": "Claudie André-Deshays Haigneré (born 13 May 1957) is a French former astronaut with the Centre National d'Études Spatiales and the European Space Agency. She was the first French woman to go the space and the first European woman to visit the International Space Station.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/claudie2520haigner25c325a9_image_20181129095923.jpg", "wiki": "https://en.wikipedia.org/wiki/Claudie_Haigneré", "last_flight": "2001-10-21T08:59:35Z", "first_flight": "1996-08-17T13:18:03Z" } }, { "id": 2679, "role": { "id": 3, "role": "Flight Engineer", "priority": 2 }, "astronaut": { "id": 274, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/274/?format=api", "name": "Yury Usachov", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P552DT22H23M37S", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "date_of_birth": "1957-10-09", "date_of_death": null, "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Yury Vladimirovich Usachov (Russian: Юрий Владимирович Усачёв; born October 9, 1957 in Donetsk, Rostov Oblast, Russia) is a former cosmonaut who resides in Star City, Moscow. Usachov is a veteran of four spaceflights, including two long duration missions on board the Mir Space Station and another on board the International Space Station.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/yury2520usachov_image_20181201223522.jpg", "wiki": "https://en.wikipedia.org/wiki/Yury_Usachov", "last_flight": "2001-03-08T11:42:09Z", "first_flight": "1994-01-08T10:05:34Z" } } ], "spacecraft": { "id": 107, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/107/?format=api", "name": "Soyuz TM-23", "serial_number": "Soyuz TM 11F732A51 #72", "is_placeholder": false, "in_space": false, "time_in_space": "P193DT19H6M55S", "time_docked": "P191DT13H59M25S", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Soyuz TM-23 was a Soyuz spacecraft which launched on 21 February 1996 12:34 UTC. It transported two members of the Expedition 21 crew to Mir. The crew consisted of Yuri Onufrienko and Yury Usachov.", "spacecraft_config": { "id": 41, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/41/?format=api", "name": "Soyuz TM", "type": { "id": 2, "name": "Capsule" }, "agency": { "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", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png" }, "in_use": false, "capability": "Manned and Cargo ISS & Mir Logistics, Lifeboat", "history": "The Soyuz-TM crew transports were fourth generation Soyuz spacecraft, and were used from 1986 to 2002 for ferry flights to Mir and the International Space Statio", "details": "Soyuz is a series of spacecraft designed for the Soviet space programme by the Korolyov Design Bureau (now RKK Energia) in the 1960s that remains in service today. The Soyuz succeeded the Voskhod spacecraft and was originally built as part of the Soviet Manned Lunar programme. The Soyuz spacecraft is launched on a Soyuz rocket, the most frequently used and most reliable launch vehicle in the world to date. The Soyuz rocket design is based on the Vostok launcher, which in turn was based on the 8K74 or R-7A Semyorka, a Soviet intercontinental ballistic missile. All Soyuz spacecraft are launched from the Baikonur Cosmodrome in Kazakhstan.", "maiden_flight": "1986-05-21", "height": 7.48, "diameter": 2.72, "human_rated": true, "crew_capacity": 3, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "180 days while docked", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_tm_image_20231228130713.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Soyuz-TM", "info_link": "" } }, "landing": { "id": 850, "attempt": true, "success": true, "description": "The Soyuz spacecraft safely landed in Kazakhstan.", "downrange_distance": null, "location": { "id": 19, "name": "Kazakhstan", "abbrev": "KAZ", "description": "Deserts of Kazakhstan in Central Asia", "location": null, "successful_landings": 193 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [ { "id": 33, "spacestation": { "id": 5, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/5/?format=api", "name": "Mir", "status": { "id": 2, "name": "De-Orbited" }, "founded": "1986-02-20", "description": "Mir was a space station that operated in low Earth orbit from 1986 to 2001, operated by the Soviet Union and later by Russia. Mir was the first modular space station and was assembled in orbit from 1986 to 1996.\r\n\r\nThe station served as a microgravity research laboratory in which crews conducted experiments in biology, human biology, physics, astronomy, meteorology and spacecraft systems with a goal of developing technologies required for permanent occupation of space.", "orbit": "Low Earth Orbit", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mir_image_20190218204938.jpeg" }, "docking": "1996-02-23T14:20:35Z", "departure": "1996-09-02T04:20:00Z", "docking_location": { "id": 29, "name": "Mir Core aft", "spacestation": { "id": 5, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/5/?format=api", "name": "Mir" } } } ] } }, "mission": { "id": 368, "name": "Soyuz TM-23", "description": "Soyuz TM-23 was the 25th mission and the 21st long-duration expedition to Mir space station. It was also a part of the US/Russian Shuttle-Mir Program.\nThe mission began on February 21, 1996, 12:34:05 UTC, launching Commander Yuri Onufrienko and Flight Engineer Yury Usachov into orbit. They docked with Mir two days later. During their stay there, cosmonauts performed several EVAs and various scientific experiments. Station crew was visited by several Progress resupply spacecrafts, STS-76, and welcomed aboard Soyuz TM-24 with the next expedition crew. \nThe mission concluded with a safe landing back on Earth on September 2, 1996, 07:41:40 UTC.", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 32, "url": "https://ll.thespacedevs.com/2.2.0/pad/32/?format=api", "agency_id": null, "name": "1/5", "description": null, "info_url": null, "wiki_url": "", "map_url": "https://www.google.com/maps?q=45.92,63.342", "latitude": "45.92", "longitude": "63.342", "location": { "id": 15, "url": "https://ll.thespacedevs.com/2.2.0/location/15/?format=api", "name": "Baikonur Cosmodrome, Republic of Kazakhstan", "country_code": "KAZ", "description": "The Baikonur Cosmodrome is a spaceport operated by Russia within Kazakhstan. Located in the Kazakh city of Baikonur, it is the largest operational space launch facility in terms of area. All Russian crewed spaceflights are launched from Baikonur.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_15_20200803142517.jpg", "timezone_name": "Asia/Qyzylorda", "total_launch_count": 1554, "total_landing_count": 0 }, "country_code": "KAZ", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_32_20200803143513.jpg", "total_launch_count": 487, "orbital_launch_attempt_count": 487 }, "infoURLs": [], "vidURLs": [], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz2520u_image_20190222031023.jpeg", "infographic": null, "program": [ { "id": 8, "url": "https://ll.thespacedevs.com/2.2.0/program/8/?format=api", "name": "Soyuz", "description": "The Soyuz programme is a human spaceflight programme initiated by the Soviet Union in the early 1960s. The Soyuz spacecraft was originally part of a Moon landing project intended to put a Soviet cosmonaut on the Moon. It was the third Soviet human spaceflight programme after the Vostok and Voskhod programmes.", "agencies": [ { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, { "id": 66, "url": "https://ll.thespacedevs.com/2.2.0/agencies/66/?format=api", "name": "Soviet Space Program", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_program_20201129185543.png", "start_date": "1966-11-28T11:02:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz_programme", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } }, { "id": 16, "url": "https://ll.thespacedevs.com/2.2.0/program/16/?format=api", "name": "Mir", "description": "Mir was a space station that operated in low Earth orbit from 1986 to 2001, operated by the Soviet Union and later by Russia. Mir was the first modular space station and was assembled in orbit from 1986 to 1996.", "agencies": [ { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, { "id": 66, "url": "https://ll.thespacedevs.com/2.2.0/agencies/66/?format=api", "name": "Soviet Space Program", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mir_program_20200821092345.jpeg", "start_date": "1986-02-20T21:28:23Z", "end_date": "2001-03-23T05:59:00Z", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Mir", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 4053, "location_launch_attempt_count": 1071, "pad_launch_attempt_count": 336, "agency_launch_attempt_count": 58, "orbital_launch_attempt_count_year": 12, "location_launch_attempt_count_year": 3, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P64DT22H2M30S", "mission_patches": [ { "id": 243, "name": "Soyuz TM-23 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/soyuz2520tm-23_mission_patch_20211031042740.png", "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" } } ], "type": "detailed" }
