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/a40351c3-ef4e-48a8-9ab5-926340aeba18/?format=api
{ "id": "a40351c3-ef4e-48a8-9ab5-926340aeba18", "url": "https://ll.thespacedevs.com/2.2.0/launch/a40351c3-ef4e-48a8-9ab5-926340aeba18/?format=api", "slug": "soyuz-u-soyuz-tm-25", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz-U | Soyuz TM-25", "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:46Z", "updates": [], "net": "1997-02-10T14:09:30Z", "net_precision": null, "window_end": "1997-02-10T14:09:30Z", "window_start": "1997-02-10T14:09:30Z", "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": 411, "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": 231, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/231/?format=api", "mission_end": "1997-08-14T12:17:00Z", "destination": "Mir", "launch_crew": [ { "id": 2611, "role": { "id": 1, "role": "Commander", "priority": 0 }, "astronaut": { "id": 272, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/272/?format=api", "name": "Vasily Tsibliyev", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P381DT15H52M32S", "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": "1954-02-20", "date_of_death": null, "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Vasily Vasiliyevich Tsibliyev (Russian: Василий Василиевич Циблиев); born on February 20, 1954) is a Russian cosmonaut.\r\n\r\nHe was selected as a cosmonaut on March 26, 1987. Tsibliyev flew as Commander on Soyuz TM-17 from July 1, 1993 to January 14, 1994 and on Soyuz TM-25 from February 2, 1997 to August 14 of the same year. He retired on June 19, 1998. Tsibliyev is currently Chief of the Yuri Gagarin Cosmonauts Training Center at Star City, Russia.\r\n\r\nTsibliyev was the commander in charge of Mir when it was hit by a Progress spacecraft in 1997.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vasily2520tsibliyev_image_20181201223334.jpg", "wiki": "https://en.wikipedia.org/wiki/Vasily_Tsibliyev", "last_flight": "1997-02-10T14:09:30Z", "first_flight": "1993-07-01T14:32:58Z" } }, { "id": 2613, "role": { "id": 3, "role": "Flight Engineer", "priority": 2 }, "astronaut": { "id": 179, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/179/?format=api", "name": "Aleksandr Lazutkin", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P184DT22H7M30S", "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-30", "date_of_death": null, "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Aleksandr Ivanovich Lazutkin (Russian: Александр Иванович Лазуткин; born October 30, 1957) is a Russian cosmonaut.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/aleksandr2520lazutkin_image_20181129234830.jpg", "wiki": "https://en.wikipedia.org/wiki/Aleksandr_Lazutkin", "last_flight": "1997-02-10T14:09:30Z", "first_flight": "1997-02-10T14:09:30Z" } }, { "id": 2615, "role": { "id": 11, "role": "Research Cosmonaut", "priority": 2 }, "astronaut": { "id": 98, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/98/?format=api", "name": "Reinhold Ewald", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P19DT16H34M30S", "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": "1956-12-18", "date_of_death": null, "nationality": "German", "twitter": null, "instagram": null, "bio": "Dr. Reinhold Ewald (born December 18, 1956) is a German physicist and ESA astronaut.\r\n\r\nIn 1990, he was selected to the German astronaut team, training for the Mir '92 mission. He was the backup of Klaus-Dietrich Flade for the Soyuz TM-14 mission. In 1995 he began training for the second German Mir mission. In February 1997 he flew to the space station Mir with Soyuz TM-25, spending 20 days in space. He performed experiments in biomedical and material sciences, and carried out operational tests in preparation for the International Space Station.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/reinhold2520ewald_image_20181128230159.jpg", "wiki": "https://en.wikipedia.org/wiki/Reinhold_Ewald", "last_flight": "1997-02-10T14:09:30Z", "first_flight": "1997-02-10T14:09:30Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 2609, "role": { "id": 1, "role": "Commander", "priority": 0 }, "astronaut": { "id": 272, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/272/?format=api", "name": "Vasily Tsibliyev", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P381DT15H52M32S", "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": "1954-02-20", "date_of_death": null, "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Vasily Vasiliyevich Tsibliyev (Russian: Василий Василиевич Циблиев); born on February 20, 1954) is a Russian cosmonaut.\r\n\r\nHe was selected as a cosmonaut on March 26, 1987. Tsibliyev flew as Commander on Soyuz TM-17 from July 1, 1993 to January 14, 1994 and on Soyuz TM-25 from February 2, 1997 to August 14 of the same year. He retired on June 19, 1998. Tsibliyev is currently Chief of the Yuri Gagarin Cosmonauts Training Center at Star City, Russia.\r\n\r\nTsibliyev was the commander in charge of Mir when it was hit by a Progress spacecraft in 1997.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vasily2520tsibliyev_image_20181201223334.jpg", "wiki": "https://en.wikipedia.org/wiki/Vasily_Tsibliyev", "last_flight": "1997-02-10T14:09:30Z", "first_flight": "1993-07-01T14:32:58Z" } }, { "id": 2614, "role": { "id": 3, "role": "Flight Engineer", "priority": 2 }, "astronaut": { "id": 179, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/179/?format=api", "name": "Aleksandr Lazutkin", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P184DT22H7M30S", "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-30", "date_of_death": null, "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Aleksandr Ivanovich Lazutkin (Russian: Александр Иванович Лазуткин; born October 30, 1957) is a Russian cosmonaut.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/aleksandr2520lazutkin_image_20181129234830.jpg", "wiki": "https://en.wikipedia.org/wiki/Aleksandr_Lazutkin", "last_flight": "1997-02-10T14:09:30Z", "first_flight": "1997-02-10T14:09:30Z" } } ], "spacecraft": { "id": 105, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/105/?format=api", "name": "Soyuz TM-25", "serial_number": "Soyuz TM 11F732A51 #74", "is_placeholder": false, "in_space": false, "time_in_space": "P184DT22H7M30S", "time_docked": "P182DT17H4M45S", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Soyuz TM-25 was a Soyuz spacecraft which launched on 10 February 1997 14:09 UTC. It transported two members of the Expedition 23 and a German astronaut to Mir. The Expedition 23 crew consisted of Vasili Tsibliyev and Aleksandr Lazutkin. The ESA astronaut was Reinhold Ewald.", "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": 852, "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": 36, "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": "1997-02-12T15:51:13Z", "departure": "1997-08-14T08:55:58Z", "docking_location": { "id": 37, "name": "Mir Core forward", "spacestation": { "id": 5, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/5/?format=api", "name": "Mir" } } } ] } }, "mission": { "id": 367, "name": "Soyuz TM-25", "description": "Soyuz TM-25 was the 30th mission and the 23rd long-duration expedition to Mir space station. It was also a part of the US/Russian Shuttle-Mir Program.\nThe mission began on February 10, 1997, 14:09:30 UTC, launching Commander Vasili Tsibliyev, Flight Engineer Aleksandr Lazutkin and Research Cosmonaut Reinhold Ewald into orbit. They docked with Mir two days later. During their stay there, cosmonauts performed an EVA and various scientific experiments in medicine, biotechnology, Earth sciences etc. Station crew was visited by several Progress resupply spacecrafts, STS-84, and welcomed aboard Soyuz TM-26 with the next expedition crew. \nThe mission concluded with a safe landing back on Earth on August 14, 1997, 12:17:10 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": 4122, "location_launch_attempt_count": 1085, "pad_launch_attempt_count": 341, "agency_launch_attempt_count": 66, "orbital_launch_attempt_count_year": 4, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P82DT14H48M52S", "mission_patches": [ { "id": 245, "name": "Soyuz TM-25 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/soyuz2520tm-25_mission_patch_20211031042741.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" }
