Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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/45b977f2-3b80-49b0-8cce-904de7e7ab6d/?format=api
{ "id": "45b977f2-3b80-49b0-8cce-904de7e7ab6d", "url": "https://ll.thespacedevs.com/2.0.0/launch/45b977f2-3b80-49b0-8cce-904de7e7ab6d/?format=api", "launch_library_id": 166, "slug": "space-shuttle-columbia-ov-102-sts-4", "name": "Space Shuttle Columbia / OV-102 | STS-4", "status": { "id": 3, "name": "Success" }, "net": "1982-06-27T15:00:00Z", "window_end": "1982-06-27T15:00:00Z", "window_start": "1982-06-27T15:00:00Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": -1, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 102, "url": "https://ll.thespacedevs.com/2.0.0/agencies/102/?format=api", "name": "Rockwell International", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "ROI", "description": null, "administrator": null, "founding_year": null, "launchers": "", "spacecraft": "", "launch_library_url": null, "total_launch_count": 8, "consecutive_successful_launches": 8, "successful_launches": 8, "failed_launches": 0, "pending_launches": 0, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "info_url": "https://www.rockwellautomation.com/", "wiki_url": "http://en.wikipedia.org/wiki/Rockwell_International", "logo_url": null, "image_url": null, "nation_url": null }, "rocket": { "id": 285, "configuration": { "id": 493, "launch_library_id": null, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/493/?format=api", "name": "Space Shuttle", "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.0.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.0.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.0.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" } ], "variant": "", "alias": "", "min_stage": 2, "max_stage": 2, "length": 56.1, "diameter": 8.0, "maiden_flight": "1981-04-12", "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 }, "launcher_stage": [], "spacecraft_stage": { "id": 47, "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/flight/47/?format=api", "mission_end": "1982-07-04T16:09:00Z", "destination": "Low Earth Orbit", "launch_crew": [ { "id": 1097, "role": "Commander", "astronaut": { "id": 311, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/311/?format=api", "name": "Ken Mattingly", "type": { "id": 2, "name": "Government" }, "status": { "id": 11, "name": "Deceased" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.0.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1936-03-17", "date_of_death": "2023-10-31", "nationality": "American", "twitter": null, "instagram": null, "bio": "Thomas Kenneth Mattingly II better known as Ken Mattingly, is a former American naval officer and aviator, aeronautical engineer, test pilot, Rear Admiral in the United States Navy and astronaut who flew on the Apollo 16, STS-4 and STS-51-C missions. He had been scheduled to fly on Apollo 13, but was held back due to concerns about a potential illness (which he did not contract). He later flew as Command Module Pilot for Apollo 16, making him one of only 24 people to have flown to the Moon.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ken_mattingly_image_20231103055657.jpeg", "wiki": "https://en.wikipedia.org/wiki/Ken_Mattingly", "last_flight": "1985-01-24T19:50:00Z", "first_flight": "1972-04-16T17:54:00Z" } }, { "id": 1099, "role": "Pilot", "astronaut": { "id": 129, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/129/?format=api", "name": "Henry 'Hank' Hartsfield", "type": { "id": 2, "name": "Government" }, "status": { "id": 11, "name": "Deceased" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.0.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1933-11-21", "date_of_death": "2014-07-14", "nationality": "American", "twitter": null, "instagram": null, "bio": "Henry Warren \"Hank\" Hartsfield Jr. was a United States Air Force officer and a USAF and NASA astronaut who logged over 480 hours in space. Hartsfield became a NASA astronaut in September 1969. Hartsfield was the pilot on STS-4, the fourth and final orbital test flight of the shuttle Columbia.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/henry25202527hank25272520hartsfield_image_20181129203753.jpg", "wiki": "https://en.wikipedia.org/wiki/Henry_Hartsfield", "last_flight": "1985-10-30T17:00:00Z", "first_flight": "1982-06-27T15:00:00Z" } } ], "onboard_crew": [], "landing_crew": [ { "id": 1098, "role": "Commander", "astronaut": { "id": 311, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/311/?format=api", "name": "Ken Mattingly", "type": { "id": 2, "name": "Government" }, "status": { "id": 11, "name": "Deceased" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.0.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1936-03-17", "date_of_death": "2023-10-31", "nationality": "American", "twitter": null, "instagram": null, "bio": "Thomas Kenneth Mattingly II better known as Ken Mattingly, is a former American naval officer and aviator, aeronautical engineer, test pilot, Rear Admiral in the United States Navy and astronaut who flew on the Apollo 16, STS-4 and STS-51-C missions. He had been scheduled to fly on Apollo 13, but was held back due to concerns about a potential illness (which he did not contract). He later flew as Command Module Pilot for Apollo 16, making him one of only 24 people to have flown to the Moon.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ken_mattingly_image_20231103055657.jpeg", "wiki": "https://en.wikipedia.org/wiki/Ken_Mattingly", "last_flight": "1985-01-24T19:50:00Z", "first_flight": "1972-04-16T17:54:00Z" } }, { "id": 97, "role": "Pilot", "astronaut": { "id": 129, "url": "https://ll.thespacedevs.com/2.0.0/astronaut/129/?format=api", "name": "Henry 'Hank' Hartsfield", "type": { "id": 2, "name": "Government" }, "status": { "id": 11, "name": "Deceased" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.0.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "date_of_birth": "1933-11-21", "date_of_death": "2014-07-14", "nationality": "American", "twitter": null, "instagram": null, "bio": "Henry Warren \"Hank\" Hartsfield Jr. was a United States Air Force officer and a USAF and NASA astronaut who logged over 480 hours in space. Hartsfield became a NASA astronaut in September 1969. Hartsfield was the pilot on STS-4, the fourth and final orbital test flight of the shuttle Columbia.", "profile_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/henry25202527hank25272520hartsfield_image_20181129203753.jpg", "wiki": "https://en.wikipedia.org/wiki/Henry_Hartsfield", "last_flight": "1985-10-30T17:00:00Z", "first_flight": "1982-06-27T15:00:00Z" } } ], "spacecraft": { "id": 36, "url": "https://ll.thespacedevs.com/2.0.0/spacecraft/36/?format=api", "name": "Space Shuttle Columbia", "serial_number": "OV-102", "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.0.0/config/spacecraft/14/?format=api", "name": "Space Shuttle", "type": { "id": 3, "name": "Spaceplane" }, "agency": { "id": 44, "url": "https://ll.thespacedevs.com/2.0.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" }, "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, "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": "" } }, "docking_events": [] } }, "mission": { "id": 502, "launch_library_id": 900, "name": "STS-4", "description": "STS-4 was the fourth flight of the Space Shuttle program. The mission flew for a week in orbit and was the final test of the Space Shuttle. Further missions declared it officially operational.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" } }, "pad": { "id": 87, "url": "https://ll.thespacedevs.com/2.0.0/pad/87/?format=api", "agency_id": 121, "name": "Launch Complex 39A", "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.0.0/location/27/?format=api", "name": "Kennedy Space Center, FL, USA", "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_27_20200803142447.jpg", "total_launch_count": 264, "total_landing_count": 0 }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_87_20200803143537.jpg", "total_launch_count": 206 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "title": "STS-4: Space Shuttle Columbia", "description": "STS-4 was the fourth NASA Space Shuttle mission, and also the fourth for Space Shuttle Columbia. The mission launched on 27 June 1982 and landed a week later...", "feature_image": "https://i.ytimg.com/vi/DtuRPUoqelI/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=DtuRPUoqelI" } ], "webcast_live": false, "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.0.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.0.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" } ], "orbital_launch_attempt_count": 2585, "location_launch_attempt_count": 21, "pad_launch_attempt_count": 16, "agency_launch_attempt_count": 3, "orbital_launch_attempt_count_year": 68, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 2, "agency_launch_attempt_count_year": 2 }
