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/038e9bee-75c0-4b8e-afe1-bf66a474c091/?format=api
{ "id": "038e9bee-75c0-4b8e-afe1-bf66a474c091", "url": "https://ll.thespacedevs.com/2.2.0/launch/038e9bee-75c0-4b8e-afe1-bf66a474c091/?format=api", "slug": "space-shuttle-columbia-ov-102-sts-1", "flightclub_url": null, "r_spacex_api_id": null, "name": "Space Shuttle Columbia / OV-102 | STS-1", "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:45:20Z", "updates": [], "net": "1981-04-12T12:00:04Z", "net_precision": null, "window_end": "1981-04-12T12:00:04Z", "window_start": "1981-04-12T12:00:04Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "featured": true, "type": "Government", "country_code": "USA", "abbrev": "NASA", "description": "The National Aeronautics and Space Administration is an independent agency of the executive branch of the United States federal government responsible for the civilian space program, as well as aeronautics and aerospace research. NASA have many launch facilities but most are inactive. The most commonly used pad will be LC-39B at Kennedy Space Center in Florida.", "administrator": "Acting Administrator: James Free", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 141, "consecutive_successful_launches": 11, "successful_launches": 121, "failed_launches": 20, "pending_launches": 6, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.nasa.gov", "wiki_url": "http://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" }, "rocket": { "id": 279, "configuration": { "id": 493, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/493/?format=api", "name": "Space Shuttle", "active": false, "reusable": true, "description": "The Space Shuttle is a retired, partially reusable low Earth orbital spacecraft system operated from 1981 to 2011 by the U.S. National Aeronautics and Space Administration (NASA) as part of the Space Shuttle program. Its official program name was Space Transportation System (STS). Five complete Space Shuttle orbiter vehicles were built and flown on a total of 135 missions from 1981 to 2011.", "family": "", "full_name": "Space Shuttle", "manufacturer": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "featured": true, "type": "Government", "country_code": "USA", "abbrev": "NASA", "description": "The National Aeronautics and Space Administration is an independent agency of the executive branch of the United States federal government responsible for the civilian space program, as well as aeronautics and aerospace research. NASA have many launch facilities but most are inactive. The most commonly used pad will be LC-39B at Kennedy Space Center in Florida.", "administrator": "Acting Administrator: James Free", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 141, "consecutive_successful_launches": 11, "successful_launches": 121, "failed_launches": 20, "pending_launches": 6, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "http://www.nasa.gov", "wiki_url": "http://en.wikipedia.org/wiki/National_Aeronautics_and_Space_Administration", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" }, "program": [ { "id": 6, "url": "https://ll.thespacedevs.com/2.2.0/program/6/?format=api", "name": "Space Shuttle", "description": "The Space Shuttle program was the fourth human spaceflight program carried out by the National Aeronautics and Space Administration (NASA), which accomplished routine transportation for Earth-to-orbit crew and cargo from 1981 to 2011.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space2520shutt_program_20200820202237.png", "start_date": "1981-04-12T12:00:03Z", "end_date": "2011-07-08T15:29:00Z", "info_url": "https://www.nasa.gov/mission_pages/shuttle/main/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Space_Shuttle_program", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "variant": "", "alias": "", "min_stage": 2, "max_stage": 2, "length": 56.1, "diameter": 8.0, "maiden_flight": "1981-04-12", "launch_cost": "450000000", "launch_mass": 2030, "leo_capacity": 27500, "gto_capacity": null, "to_thrust": 28200, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space_shuttle_image_20230422074810.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Space_Shuttle", "total_launch_count": 135, "consecutive_successful_launches": 22, "successful_launches": 133, "failed_launches": 2, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/44/?format=api", "mission_end": "1981-04-14T18:20:00Z", "destination": "Low Earth Orbit", "launch_crew": [ { "id": 980, "role": { "id": 1, "role": "Commander", "priority": 0 }, "astronaut": { "id": 32, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/32/?format=api", "name": "John Young", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P25DT37M55S", "status": { "id": 11, "name": "Deceased" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1930-09-24", "date_of_death": "2018-01-05", "nationality": "American", "twitter": null, "instagram": null, "bio": "John Watts Young was an American astronaut, naval officer and aviator, test pilot, and aeronautical engineer. He became the ninth person to walk on the Moon as Commander of the Apollo 16 mission in 1972. Young enjoyed the longest career of any astronaut, becoming the first person to fly six space missions (with seven launches, counting his lunar liftoff) over the course of 42 years of active NASA service. He is the only person to have piloted, and been commander of, four different classes of spacecraft: Gemini, the Apollo Command/Service Module, the Apollo Lunar Module, and the Space Shuttle.\r\n\r\nIn 1965, Young flew on the first manned Gemini mission, and commanded another Gemini mission the next year. In 1969 during Apollo 10, he became the first person to fly solo around the Moon. He drove the Lunar Roving Vehicle on the Moon's surface during Apollo 16, and is one of only three people to have flown to the Moon twice. He also commanded two Space Shuttle flights, including its first launch in 1981, and served as Chief of the Astronaut Office from 1974 to 1987. Young retired from NASA in 2004. He died on January 5, 2018.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/john2520young_image_20190426143657.jpeg", "wiki": "https://en.wikipedia.org/wiki/John_Young_(astronaut)", "last_flight": "1983-11-28T16:00:00Z", "first_flight": "1965-03-23T14:24:00Z" } }, { "id": 1089, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 328, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/328/?format=api", "name": "Robert Crippen", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P23DT13H45M56S", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1937-09-11", "date_of_death": null, "nationality": "American", "twitter": null, "instagram": null, "bio": "Robert Laurel Crippen is an American retired naval officer and aviator, test pilot, aerospace engineer, and retired astronaut. He traveled into space four times: as Pilot of STS-1 in April 1981, the first Space Shuttle mission; and as Commander of STS-7 in June 1983, STS-41-C in April 1984, and STS-41-G in October 1984. Crippen received the Congressional Space Medal of Honor.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/robert2520crippen_image_20181202093705.jpg", "wiki": "https://en.wikipedia.org/wiki/Robert_Crippen", "last_flight": "1984-10-05T11:03:00Z", "first_flight": "1981-04-12T12:00:04Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 982, "role": { "id": 1, "role": "Commander", "priority": 0 }, "astronaut": { "id": 32, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/32/?format=api", "name": "John Young", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P25DT37M55S", "status": { "id": 11, "name": "Deceased" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1930-09-24", "date_of_death": "2018-01-05", "nationality": "American", "twitter": null, "instagram": null, "bio": "John Watts Young was an American astronaut, naval officer and aviator, test pilot, and aeronautical engineer. He became the ninth person to walk on the Moon as Commander of the Apollo 16 mission in 1972. Young enjoyed the longest career of any astronaut, becoming the first person to fly six space missions (with seven launches, counting his lunar liftoff) over the course of 42 years of active NASA service. He is the only person to have piloted, and been commander of, four different classes of spacecraft: Gemini, the Apollo Command/Service Module, the Apollo Lunar Module, and the Space Shuttle.\r\n\r\nIn 1965, Young flew on the first manned Gemini mission, and commanded another Gemini mission the next year. In 1969 during Apollo 10, he became the first person to fly solo around the Moon. He drove the Lunar Roving Vehicle on the Moon's surface during Apollo 16, and is one of only three people to have flown to the Moon twice. He also commanded two Space Shuttle flights, including its first launch in 1981, and served as Chief of the Astronaut Office from 1974 to 1987. Young retired from NASA in 2004. He died on January 5, 2018.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/john2520young_image_20190426143657.jpeg", "wiki": "https://en.wikipedia.org/wiki/John_Young_(astronaut)", "last_flight": "1983-11-28T16:00:00Z", "first_flight": "1965-03-23T14:24:00Z" } }, { "id": 90, "role": { "id": 2, "role": "Pilot", "priority": 2 }, "astronaut": { "id": 328, "url": "https://ll.thespacedevs.com/2.2.0/astronaut/328/?format=api", "name": "Robert Crippen", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P23DT13H45M56S", "status": { "id": 2, "name": "Retired" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1937-09-11", "date_of_death": null, "nationality": "American", "twitter": null, "instagram": null, "bio": "Robert Laurel Crippen is an American retired naval officer and aviator, test pilot, aerospace engineer, and retired astronaut. He traveled into space four times: as Pilot of STS-1 in April 1981, the first Space Shuttle mission; and as Commander of STS-7 in June 1983, STS-41-C in April 1984, and STS-41-G in October 1984. Crippen received the Congressional Space Medal of Honor.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/robert2520crippen_image_20181202093705.jpg", "wiki": "https://en.wikipedia.org/wiki/Robert_Crippen", "last_flight": "1984-10-05T11:03:00Z", "first_flight": "1981-04-12T12:00:04Z" } } ], "spacecraft": { "id": 36, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/36/?format=api", "name": "Space Shuttle Columbia", "serial_number": "OV-102", "is_placeholder": false, "in_space": false, "time_in_space": "P292DT16H28M27S", "time_docked": "P7DT33M", "flights_count": 28, "mission_ends_count": 28, "status": { "id": 3, "name": "Destroyed" }, "description": "Space Shuttle Columbia (Orbiter Vehicle Designation: OV-102) was the first space-rated orbiter in NASA's Space Shuttle fleet. It launched for the first time on mission STS-1 on April 12, 1981, the first flight of the Space Shuttle program. Over 22 years of service, it completed 27 missions before disintegrating during re-entry near the end of its 28th mission, STS-107 on February 1, 2003, resulting in the deaths of all seven crew members.", "spacecraft_config": { "id": 14, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/14/?format=api", "name": "Space Shuttle", "type": { "id": 3, "name": "Spaceplane" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "featured": true, "type": "Government", "country_code": "USA", "abbrev": "NASA", "description": "The National Aeronautics and Space Administration is an independent agency of the executive branch of the United States federal government responsible for the civilian space program, as well as aeronautics and aerospace research. NASA have many launch facilities but most are inactive. The most commonly used pad will be LC-39B at Kennedy Space Center in Florida.", "administrator": "Acting Administrator: James Free", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "parent": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png" }, "in_use": false, "capability": "Carrying a crew of 7 astronauts along with cargo to Low Earth Orbit.", "history": "The Space shuttle was a United States space craft. Following the conclusion of the Apollo program the Space Shuttle intended to lower costs for reliable access to Low Earth Orbit. The program ran from 1981-2011.", "details": "The Space Shuttle was a partially reusable LEO spacecraft system operated by the U.S. National Aeronautics and Space Administration (NASA) as part of the Space Shuttle program. Its official program name was Space Transportation System (STS), taken from a 1969 plan for a system of reusable spacecraft of which it was the only item funded for development. The first of four orbital test flights occurred in 1981, leading to operational flights in 1982. In addition to the prototype whose completion was cancelled, five complete Shuttle systems were built and used on a total of 135 missions from 1981 to 2011, launched from the Kennedy Space Center (KSC) in Florida. Operational missions launched numerous satellites, interplanetary probes, and the Hubble Space Telescope (HST); conducted science experiments in orbit; and participated in construction and servicing of the International Space Station. The Shuttle fleet's total mission time was 1322 days, 19 hours, 21 minutes and 23 seconds.", "maiden_flight": "1981-04-12", "height": 56.1, "diameter": 8.7, "human_rated": true, "crew_capacity": 7, "payload_capacity": 27500, "payload_return_capacity": null, "flight_life": "14 days", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space2520shuttle_image_20190207032524.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Space_Shuttle", "info_link": "" } }, "landing": { "id": 954, "attempt": true, "success": true, "description": "Space Shuttle Columbia successfully landed at Edwards Air Force Base after this mission.", "downrange_distance": null, "location": { "id": 23, "name": "Edwards Air Force Base", "abbrev": "KEDW", "description": "Edwards Air Force Base in California.", "location": { "id": 162, "url": "https://ll.thespacedevs.com/2.2.0/location/162/?format=api", "name": "Edwards Air Force Base", "country_code": "USA", "description": "Edwards Air Force Base is a United States Air Force installation in California. Edwards is the home of the Air Force Test Center, Air Force Test Pilot School, and NASA's Armstrong Flight Research Center. It is the Air Force Materiel Command center for conducting and supporting research and development of flight, as well as testing and evaluating aerospace systems from concept to combat. It also hosts many test activities conducted by America's commercial aerospace industry.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_edwards_air_force_base_20230422085221.jpg", "timezone_name": "America/Los_Angeles", "total_launch_count": 0, "total_landing_count": 0 }, "successful_landings": 66 }, "type": { "id": 6, "name": "Horizontal Landing", "abbrev": "HL", "description": "Horizontal landing on a runway or flat surface." } }, "docking_events": [] } }, "mission": { "id": 482, "name": "STS-1", "description": "STS-1 was the first orbital spaceflight of the Space Shuttle Program. The first orbiter Columbia took a 54.5 hour flight and circled the Earth 36 times. This was NASAs first craft to be manned during a testflight. Manned by John Young and Bob Crippen.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 87, "url": "https://ll.thespacedevs.com/2.2.0/pad/87/?format=api", "agency_id": 121, "name": "Launch Complex 39A", "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Kennedy_Space_Center_Launch_Complex_39#Launch_Pad_39A", "map_url": "https://www.google.com/maps?q=28.60822681,-80.60428186", "latitude": "28.60822681", "longitude": "-80.60428186", "location": { "id": 27, "url": "https://ll.thespacedevs.com/2.2.0/location/27/?format=api", "name": "Kennedy Space Center, FL, USA", "country_code": "USA", "description": "The John F. Kennedy Space Center, located on Merritt Island, Florida, is one of NASA's ten field centers. Since 1968, KSC has been NASA's primary launch center of American spaceflight, research, and technology. Launch operations for the Apollo, Skylab and Space Shuttle programs were carried out from Kennedy Space Center Launch Complex 39 and managed by KSC. Located on the east coast of Florida, KSC is adjacent to Cape Canaveral Space Force Station (CCSFS).", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_27_20200803142447.jpg", "timezone_name": "America/New_York", "total_launch_count": 260, "total_landing_count": 0 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_87_20200803143537.jpg", "total_launch_count": 202, "orbital_launch_attempt_count": 201 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "STS-1: Space Shuttle Columbia", "description": "The first ever space shuttle launch. One of only two that has the external tank painted white. Launching from Space Launch Complex 39A, Cape Canaveral, Flori...", "feature_image": "https://i.ytimg.com/vi/5TzB_iv24-E/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=5TzB_iv24-E", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space_shuttle_image_20230422074810.jpeg", "infographic": null, "program": [ { "id": 6, "url": "https://ll.thespacedevs.com/2.2.0/program/6/?format=api", "name": "Space Shuttle", "description": "The Space Shuttle program was the fourth human spaceflight program carried out by the National Aeronautics and Space Administration (NASA), which accomplished routine transportation for Earth-to-orbit crew and cargo from 1981 to 2011.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/space2520shutt_program_20200820202237.png", "start_date": "1981-04-12T12:00:03Z", "end_date": "2011-07-08T15:29:00Z", "info_url": "https://www.nasa.gov/mission_pages/shuttle/main/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Space_Shuttle_program", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 2427, "location_launch_attempt_count": 18, "pad_launch_attempt_count": 13, "agency_launch_attempt_count": 135, "orbital_launch_attempt_count_year": 36, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P2889DT18H30M4S", "mission_patches": [ { "id": 584, "name": "STS-1 Mission Patch", "priority": 9, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/sts-12520missi_mission_patch_20211102202441.png", "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } } ], "type": "detailed" }
