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/89ee335d-53bd-49e0-a774-921321f5926f/?format=api
{ "id": "89ee335d-53bd-49e0-a774-921321f5926f", "url": "https://ll.thespacedevs.com/2.2.0/launch/89ee335d-53bd-49e0-a774-921321f5926f/?format=api", "slug": "soyuz-21b-uzlovoy-module-um-prichal", "flightclub_url": null, "r_spacex_api_id": null, "name": "Soyuz 2.1b | Uzlovoy Module (UM) \"Prichal\"", "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-14T03:41:29Z", "updates": [ { "id": 1017, "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/profile_images/robin2520bouchet_profile_20210817214050.png", "comment": "Setting launch as successful based on ROSCOSMOS Tweet", "info_url": "https://twitter.com/roscosmos/status/1463496896127946755", "created_by": "Rob1bouchet", "created_on": "2021-11-24T13:20:10Z" }, { "id": 1005, "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "T-0 confirmed by ROSCOSMOS", "info_url": "https://www.roscosmos.ru/33204/", "created_by": "Nosu", "created_on": "2021-11-20T10:57:34Z" }, { "id": 907, "profile_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/profile_images/arnaud2520muller_profile_20230607144351.jpg", "comment": "Adding launch time", "info_url": "https://spaceflightnow.com/launch-schedule/", "created_by": "Nosu", "created_on": "2021-10-23T22:12:39Z" } ], "net": "2021-11-24T13:06:36Z", "net_precision": null, "window_end": "2021-11-24T13:06:36Z", "window_start": "2021-11-24T13:06:36Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "", "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": 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": 149, "configuration": { "id": 15, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/15/?format=api", "name": "Soyuz 2.1b", "active": true, "reusable": false, "description": "Soyuz-2 is 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 2.1b version adds an upgraded engine (RD-0124) with improved performance to the second stage.", "family": "Soyuz", "full_name": "Soyuz 2.1b", "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": "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": "", "alias": "", "min_stage": 2, "max_stage": 3, "length": 46.3, "diameter": 2.95, "maiden_flight": "2008-07-26", "launch_cost": "80000000", "launch_mass": 312, "leo_capacity": 8200, "gto_capacity": 3250, "to_thrust": null, "apogee": null, "vehicle_range": null, "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg", "info_url": null, "wiki_url": "http://en.wikipedia.org/wiki/Soyuz-2_(rocket)", "total_launch_count": 19, "consecutive_successful_launches": 19, "successful_launches": 19, "failed_launches": 0, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 766, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/766/?format=api", "mission_end": "2021-12-23T04:30:54Z", "destination": "International Space Station", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 544, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/544/?format=api", "name": "Progress M-UM", "serial_number": "M-UM (No.303)", "is_placeholder": false, "in_space": false, "time_in_space": "P28DT15H24M18S", "time_docked": "P26DT7H43M21S", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Modified Progress spacecraft used to deliver the Prichal module to the International Space Station.", "spacecraft_config": { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/37/?format=api", "name": "Progress M-UM", "type": { "id": 4, "name": "Cargo Resupply" }, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg", "logo_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/logo/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png" }, "in_use": false, "capability": "ISS Module Delivery", "history": "Progress M-UM , was a specially modified Progress M developed by Roscosmos to deliver the Prichal module to the Russian Orbital Segment of the International Space Station. The propulsion section was separable from the Princhal module.It was the final flight of a Progress M and the first launch of a Progress spacecraft on a Soyuz 2.1b.", "details": "Progress is derived from the manned Soyuz spacecraft and is launched on the same vehicle, a Soyuz rocket.\r\nThe purpose of Progress is to deliver supplies needed to sustain human presence in orbit. Currently it is used as a re-supply spacecraft for the ISS.", "maiden_flight": "2021-11-24", "height": null, "diameter": null, "human_rated": false, "crew_capacity": null, "payload_capacity": 5350, "payload_return_capacity": null, "flight_life": "1 Month", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/progress_m-um_image_20231221195834.jpg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Progress_M-UM", "info_link": "" } }, "landing": { "id": 641, "attempt": false, "success": null, "description": "The Progress spacecraft burned up upon entering Earth's atmosphere.", "downrange_distance": null, "location": null, "type": null }, "docking_events": [ { "id": 484, "spacestation": { "id": 4, "url": "https://ll.thespacedevs.com/2.2.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": "2021-11-26T15:19:39Z", "departure": "2021-12-22T23:03:00Z", "docking_location": { "id": 40, "name": "Nauka nadir", "spacestation": { "id": 4, "url": "https://ll.thespacedevs.com/2.2.0/spacestation/4/?format=api", "name": "International Space Station" } } } ] } }, "mission": { "id": 669, "name": "Uzlovoy Module (UM) \"Prichal\"", "description": "The UM (Uzlovoy Module) or NM (Node Module) is a node to be added to the Russian part of the ISS complex. It is also named Prichal.\n\nUM will be delivered by a modified Progress space tug, called Progress-M-UM. The UM will be docked to the nadir port of the MLM (Nauka) module, providing four ports to mount additional modules and one docking port for cargo and crew spacecrafts.", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 20, "url": "https://ll.thespacedevs.com/2.2.0/pad/20/?format=api", "agency_id": null, "name": "31/6", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Baikonur_Cosmodrome_Site_31", "map_url": "https://www.google.com/maps?q=45.996034,63.564003", "latitude": "45.996034", "longitude": "63.564003", "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": "", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/location_15_20200803142517.jpg", "timezone_name": "Asia/Qyzylorda", "total_launch_count": 1548, "total_landing_count": 0 }, "country_code": "KAZ", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/pad_20_20200803143516.jpg", "total_launch_count": 415, "orbital_launch_attempt_count": 415 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Soyuz Prichal", "description": "Soyuz Prichal with initial coverage and post coverage cutThumbnail Photo Credit: Roscosmos", "feature_image": "https://i.ytimg.com/vi/L02Xd8i7I3k/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=L02Xd8i7I3k", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 8, "source": null, "publisher": null, "title": "NASA Live: Official Stream of NASA TV", "description": "Direct from America's space program to YouTube, watch NASA TV live streaming here to get the latest from our exploration of the universe and learn how we dis...", "feature_image": "https://i.ytimg.com/vi/21X5lGlDOfg/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=21X5lGlDOfg", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 9, "source": null, "publisher": null, "title": "Пуск ракеты-носителя «Союз-2.1б» с грузовым кораблём-модулем «Прогресс М-УМ» с космодрома Байконур", "description": "24 ноября 2021 года в 16:06 мск запланирован пуск ракеты-носителя «Союз-2.1б» с грузовым кораблём-модулем «Прогресс М-УМ» и узловым модулем «Причал» с пусков...", "feature_image": "https://i.ytimg.com/vi/eGSlvtuRjVM/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=eGSlvtuRjVM", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 10, "source": null, "publisher": null, "title": "Техническая трансляция запуска грузового корабля-модуля «Прогресс М-УМ»", "description": "24 ноября 2021 года в 16:06 мск запланирован пуск ракеты-носителя «Союз-2.1б» с грузовым кораблём-модулем «Прогресс М-УМ» и узловым модулем «Причал» с пусков...", "feature_image": "https://i.ytimg.com/vi/j069886YdLQ/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=j069886YdLQ", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1b_image_20230802085331.jpg", "infographic": null, "program": [ { "id": 17, "url": "https://ll.thespacedevs.com/2.2.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.2.0/agencies/16/?format=api", "name": "Canadian Space Agency", "type": "Government" }, { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/agencies/27/?format=api", "name": "European Space Agency", "type": "Multinational" }, { "id": 37, "url": "https://ll.thespacedevs.com/2.2.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "type": "Government" }, { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 63, "url": "https://ll.thespacedevs.com/2.2.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", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 6145, "location_launch_attempt_count": 1526, "pad_launch_attempt_count": 397, "agency_launch_attempt_count": 299, "orbital_launch_attempt_count_year": 119, "location_launch_attempt_count_year": 11, "pad_launch_attempt_count_year": 10, "agency_launch_attempt_count_year": 7, "pad_turnaround": "P27DT13H6M4S", "mission_patches": [ { "id": 576, "name": "Prichal Mission Patch", "priority": 10, "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/mission_patch_images/prichal2520mis_mission_patch_20211031095747.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" }
