Launch Instance
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'
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.0.0/launch/ebd4748d-4991-48a7-a2f3-0535f4e1a5c1/?format=api
{ "id": "ebd4748d-4991-48a7-a2f3-0535f4e1a5c1", "url": "https://ll.thespacedevs.com/2.0.0/launch/ebd4748d-4991-48a7-a2f3-0535f4e1a5c1/?format=api", "launch_library_id": 886, "slug": "soyuz-fg-soyuz-tma-12", "name": "Soyuz-FG | Soyuz TMA-12", "status": { "id": 3, "name": "Success" }, "net": "2008-04-08T11:16:39Z", "window_end": "2008-04-08T11:16:39Z", "window_start": "2008-04-08T11:16:39Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": -1, "holdreason": "", "failreason": null, "hashtag": null, "launch_service_provider": { "id": 63, "url": "https://ll.thespacedevs.com/2.0.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": 322, "consecutive_successful_launches": 46, "successful_launches": 311, "failed_launches": 11, "pending_launches": 10, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg", "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_nation_20230531052758.jpg" }, "rocket": { "id": 1392, "configuration": { "id": 34, "launch_library_id": 36, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/34/?format=api", "name": "Soyuz", "description": "The Soyuz FG rocket is an expendable launch vehicle most commonly known for carrying humans to the International Space Station today.", "family": "", "full_name": "Soyuz FG", "manufacturer": { "id": 111, "url": "https://ll.thespacedevs.com/2.0.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": "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/progress2520rocket2520space2520center_logo_20210313175054.png", "image_url": null, "nation_url": null }, "program": [], "variant": "FG", "alias": "", "min_stage": 2, "max_stage": 2, "length": 49.5, "diameter": 3.0, "maiden_flight": "2001-05-20", "launch_mass": 305, "leo_capacity": 6450, "gto_capacity": null, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/soyuz_image_20190717035537.jpg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz-FG", "total_launch_count": 60, "consecutive_successful_launches": 5, "successful_launches": 59, "failed_launches": 1, "pending_launches": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 216, "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/flight/216/?format=api", "mission_end": "2008-10-24T03:37:00Z", "destination": "International Space Station", "launch_crew": [ { "id": 2228, "role": "Commander", "astronaut": { "id": 282, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/282/?format=api", "name": "Sergey Aleksandrovich Volkov", "type": { "id": 2, "name": "Government" }, "status": { "id": 2, "name": "Retired" }, "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.0.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "date_of_birth": "1973-04-01", "date_of_death": null, "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Sergey Aleksandrovich Volkov is a retired Russian cosmonaut and engineer. He was a member of three missions to the International Space Station, spending more than a year in total in space. During his missions he did four spacewalks lasting more than 23 hours in total. Volkov retired from the Cosmonaut group in February 2017.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/sergey2520volkov_image_20181201224637.jpg", "wiki": "https://en.wikipedia.org/wiki/Sergey_Volkov_(cosmonaut)", "last_flight": "2015-09-02T04:37:43Z", "first_flight": "2008-04-08T11:16:39Z" } }, { "id": 2538, "role": "Flight Engineer", "astronaut": { "id": 168, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/168/?format=api", "name": "Oleg Kononenko", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.0.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "date_of_birth": "1964-06-21", "date_of_death": null, "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Oleg Dmitriyevich Kononenko (Russian: Олег Дмитриевич Кононенко) is a Russian cosmonaut. He has flown to the International Space Station three times, as a flight engineer for Expedition 17 aboard Soyuz TMA-12, as a flight engineer on Expedition 30 and commander of Expedition 31 aboard Soyuz TMA-03M, and as a flight engineer on Expedition 44 and Expedition 45 aboard Soyuz TMA-17M. Kononenko has accumulated over 533 days in orbit during three long duration flights to ISS.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/oleg2520kononenko_image_20181129233442.jpg", "wiki": "https://en.wikipedia.org/wiki/Oleg_Kononenko", "last_flight": "2023-09-15T15:44:35Z", "first_flight": "2008-04-08T11:16:39Z" } }, { "id": 2533, "role": "Spaceflight Participant", "astronaut": { "id": 484, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/484/?format=api", "name": "Yi So-yeon", "type": { "id": 2, "name": "Government" }, "status": { "id": 2, "name": "Retired" }, "agency": { "id": 261, "url": "https://ll.thespacedevs.com/2.0.0/agencies/261/?format=api", "name": "Korean Astronaut Program", "type": "Government" }, "date_of_birth": "1978-06-02", "date_of_death": null, "nationality": "South Korean", "twitter": null, "instagram": null, "bio": "Yi So-yeon (born June 2, 1978) is an astronaut and biotechnologist who became the first Korean to fly in space.\r\nYi was one of the two finalists chosen on December 25, 2006 through the Korean Astronaut Program. On September 5, 2007, the Korean Ministry of Science and Technology chose Ko San, over Yi So-yeon, following performance and other tests during their training in Russia.\r\n\r\nOn March 7, 2008, she was selected to train with the primary crew, and on March 10 the Ministry of Education, Science and Technology announced that Yi would replace Ko. This was after the Russian Federal Space Agency asked for a replacement, because Ko violated regulations several times at a Russian training center by removing sensitive reading materials and mailing one back to Korea. On April 8, 2008, Yi was launched into space on board Soyuz TMA-12 with two Russian cosmonauts. South Korea is reported to have paid Russia $20 million for Yi's space flight. She is the third woman, after Helen Sharman of the United Kingdom and Anousheh Ansari an Iranian American, to be the first national from their country in space.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/yi2520so-yeon_image_20181202184152.jpg", "wiki": "https://en.wikipedia.org/wiki/Yi_So-yeon", "last_flight": "2008-04-08T11:16:39Z", "first_flight": "2008-04-08T11:16:39Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 2223, "role": "Commander", "astronaut": { "id": 282, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/282/?format=api", "name": "Sergey Aleksandrovich Volkov", "type": { "id": 2, "name": "Government" }, "status": { "id": 2, "name": "Retired" }, "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.0.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "date_of_birth": "1973-04-01", "date_of_death": null, "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Sergey Aleksandrovich Volkov is a retired Russian cosmonaut and engineer. He was a member of three missions to the International Space Station, spending more than a year in total in space. During his missions he did four spacewalks lasting more than 23 hours in total. Volkov retired from the Cosmonaut group in February 2017.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/sergey2520volkov_image_20181201224637.jpg", "wiki": "https://en.wikipedia.org/wiki/Sergey_Volkov_(cosmonaut)", "last_flight": "2015-09-02T04:37:43Z", "first_flight": "2008-04-08T11:16:39Z" } }, { "id": 2537, "role": "Flight Engineer", "astronaut": { "id": 168, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/168/?format=api", "name": "Oleg Kononenko", "type": { "id": 2, "name": "Government" }, "status": { "id": 1, "name": "Active" }, "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.0.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "date_of_birth": "1964-06-21", "date_of_death": null, "nationality": "Russian", "twitter": null, "instagram": null, "bio": "Oleg Dmitriyevich Kononenko (Russian: Олег Дмитриевич Кононенко) is a Russian cosmonaut. He has flown to the International Space Station three times, as a flight engineer for Expedition 17 aboard Soyuz TMA-12, as a flight engineer on Expedition 30 and commander of Expedition 31 aboard Soyuz TMA-03M, and as a flight engineer on Expedition 44 and Expedition 45 aboard Soyuz TMA-17M. Kononenko has accumulated over 533 days in orbit during three long duration flights to ISS.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/oleg2520kononenko_image_20181129233442.jpg", "wiki": "https://en.wikipedia.org/wiki/Oleg_Kononenko", "last_flight": "2023-09-15T15:44:35Z", "first_flight": "2008-04-08T11:16:39Z" } }, { "id": 617, "role": "Tourist", "astronaut": { "id": 620, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/620/?format=api", "name": "Richard Garriott", "type": { "id": 4, "name": "Non-Astronaut Passenger" }, "status": { "id": 2, "name": "Retired" }, "agency": null, "date_of_birth": "1961-07-04", "date_of_death": null, "nationality": "British", "twitter": "https://twitter.com/RichardGarriott", "instagram": null, "bio": "Richard Allen Garriott de Cayeux (born July 4, 1961) is an English-American video game developer and entrepreneur.\r\n\r\nOn October 12, 2008, Garriott flew aboard Soyuz TMA-13 to the International Space Station as a private astronaut, returning 12 days later aboard Soyuz TMA-12. He became the second astronaut, and first from the U.S., who had a parent that was also a space traveler.", "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/richard2520garriott_image_20190211162327.jpeg", "wiki": "https://en.wikipedia.org/wiki/Richard_Garriott", "last_flight": "2008-10-12T07:01:00Z", "first_flight": "2008-10-12T07:01:00Z" } } ], "spacecraft": { "id": 81, "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/81/?format=api", "name": "Soyuz TMA-12", "serial_number": "Soyuz TMA 11F732A17 #222", "status": { "id": 4, "name": "Single Use" }, "description": "Soyuz TMA-12 was a Soyuz spacecraft which launched on April 8 2008 11:16 UTC. It transported two members of the Expedition 17 crew and one participant to the International Space Station. The Expedition 17 crew consisted of Sergei Volkov and Oleg Kononenko. The spaceflight participant was biotechnologist Yi So-Yeon.", "spacecraft_config": { "id": 40, "url": "https://ll.thespacedevs.com/2.0.0/config/spacecraft/40/?format=api", "name": "Soyuz TMA", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 63, "url": "https://ll.thespacedevs.com/2.0.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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg" }, "in_use": false, "capability": "Manned and Cargo ISS Logistics, Lifeboat", "history": "Soyuz TMA features several changes to accommodate requirements requested by NASA in order to service the International Space Station (ISS)", "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": "2002-10-30", "height": 748.0, "diameter": 2.72, "human_rated": true, "crew_capacity": 3, "payload_capacity": null, "flight_life": "6 Months while docked", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/soyuz_tma_image_20231225093222.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Soyuz_TMA", "info_link": "" } }, "docking_events": [ { "spacestation": { "id": 4, "url": "https://ll.thespacedevs.com/2.0.0/spacestation/4/?format=api", "name": "International Space Station", "status": { "id": 1, "name": "Active" }, "founded": "1998-11-20", "description": "The International Space Station (ISS) is a space station, or a habitable artificial satellite, in low Earth orbit. Its first component was launched into orbit in 1998, with the first long-term residents arriving in November 2000. It has been inhabited continuously since that date. The last pressurised module was fitted in 2011, and an experimental inflatable space habitat was added in 2016. The station is expected to operate until 2030. Development and assembly of the station continues, with several new elements scheduled for launch in 2019. The ISS is the largest human-made body in low Earth orbit and can often be seen with the naked eye from Earth. The ISS consists of pressurised habitation modules, structural trusses, solar arrays, radiators, docking ports, experiment bays and robotic arms. ISS components have been launched by Russian Proton and Soyuz rockets, and American Space Shuttles.", "orbit": "Low Earth Orbit", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/international2520space2520station_image_20190220215716.jpeg" }, "docking": "2008-04-10T12:57:00Z", "departure": "2008-10-24T00:16:00Z", "docking_location": { "id": 18, "name": "Pirs nadir" } } ] } }, "mission": { "id": 206, "launch_library_id": 284, "name": "Soyuz TMA-12", "description": "Soyuz TMA-12 begins Expedition 17 by carrying 3 astronauts and cosmonauts to the International Space Station. \nRussian Commander, cosmonaut Sergei Volkov alongside Flight Engineers, Oleg Kononenko (RSA) & Yi So-Yeon (KAP - Korean Astronaut Program) will launch aboard the Soyuz spacecraft from the Baikonur Cosmodrome in Kazakhstan and then rendezvous with the station. \nIt landed on October 24, 2008, 03:37 UTC", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" } }, "pad": { "id": 32, "url": "https://ll.thespacedevs.com/2.0.0/pad/32/?format=api", "agency_id": null, "name": "1/5", "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.0.0/location/15/?format=api", "name": "Baikonur Cosmodrome, Republic of Kazakhstan", "country_code": "KAZ", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/location_15_20200803142517.jpg", "total_launch_count": 1548, "total_landing_count": 0 }, "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/pad_32_20200803143513.jpg", "total_launch_count": 487 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "title": "Пуск РН \"СОЮЗ-ФГ\" с КК \"СОЮЗ ТМА-12\" 08.04.08", "description": "Пуск космического корабля \"СОЮЗ ТМА-12\" Ракета-носитель: Союз-ФГ, космодром Байконур. Дата -08.04.2008 (15 ч 16 мин время московское)", "feature_image": "https://i.ytimg.com/vi/wJEdCnrQto4/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=wJEdCnrQto4" } ], "webcast_live": false, "image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/soyuz_image_20190717035537.jpg", "infographic": null, "program": [ { "id": 8, "url": "https://ll.thespacedevs.com/2.0.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.0.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, { "id": 66, "url": "https://ll.thespacedevs.com/2.0.0/agencies/66/?format=api", "name": "Soviet Space Program", "type": "Government" } ], "image_url": "https://spacelaunchnow-prod-east.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" }, { "id": 17, "url": "https://ll.thespacedevs.com/2.0.0/program/17/?format=api", "name": "International Space Station", "description": "The International Space Station programme is tied together by a complex set of legal, political and financial agreements between the sixteen nations involved in the project, governing ownership of the various components, rights to crewing and utilization, and responsibilities for crew rotation and resupply of the International Space Station. It was conceived in 1984 by President Ronald Reagan, during the Space Station Freedom project as it was originally called.", "agencies": [ { "id": 16, "url": "https://ll.thespacedevs.com/2.0.0/agencies/16/?format=api", "name": "Canadian Space Agency", "type": "Government" }, { "id": 27, "url": "https://ll.thespacedevs.com/2.0.0/agencies/27/?format=api", "name": "European Space Agency", "type": "Multinational" }, { "id": 37, "url": "https://ll.thespacedevs.com/2.0.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "type": "Government" }, { "id": 44, "url": "https://ll.thespacedevs.com/2.0.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 63, "url": "https://ll.thespacedevs.com/2.0.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" } ], "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/international2_program_20201129184745.png", "start_date": "1998-11-20T06:40:00Z", "end_date": null, "info_url": "https://www.nasa.gov/mission_pages/station/main/index.html", "wiki_url": "https://en.wikipedia.org/wiki/International_Space_Station_programme" } ], "orbital_launch_attempt_count": 4890, "location_launch_attempt_count": 1293, "pad_launch_attempt_count": 414, "agency_launch_attempt_count": 175, "orbital_launch_attempt_count_year": 15, "location_launch_attempt_count_year": 5, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2 }
