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/5b806050-3825-4b5d-b8e8-3e1ead58a041/?format=api
{ "id": "5b806050-3825-4b5d-b8e8-3e1ead58a041", "url": "https://ll.thespacedevs.com/2.2.0/launch/5b806050-3825-4b5d-b8e8-3e1ead58a041/?format=api", "slug": "saturn-v-apollo-12", "flightclub_url": null, "r_spacex_api_id": null, "name": "Saturn V | Apollo 12", "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:37:11Z", "updates": [], "net": "1969-11-14T16:22:00Z", "net_precision": null, "window_end": "1969-11-14T16:22:00Z", "window_start": "1969-11-14T16:22:00Z", "probability": -1, "weather_concerns": null, "holdreason": "", "failreason": null, "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": 226, "configuration": { "id": 93, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/93/?format=api", "name": "Saturn V", "active": false, "reusable": false, "description": "The Saturn V was a human-rated expendable rocket used by NASA between 1967 and 1973. Most notably, the Saturn V took the Apollo program to the Moon. It still remains the world's tallest, heaviest, and most powerful rocket ever brought to operational status and is the only launch vehicle to take humans beyond LEO.", "family": "Saturn", "full_name": "Saturn V", "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": 4, "url": "https://ll.thespacedevs.com/2.2.0/program/4/?format=api", "name": "Apollo", "description": "The Apollo program was the third United States human spaceflight program carried out by the National Aeronautics and Space Administration (NASA), which succeeded in landing the first humans on the Moon from 1969 to 1972.", "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/apollo_program_20200820200202.png", "start_date": "1966-11-16T00:00:00Z", "end_date": "1972-12-19T19:24:59Z", "info_url": "https://www.nasa.gov/mission_pages/apollo/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Apollo_program", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "variant": "V", "alias": "", "min_stage": 3, "max_stage": 3, "length": 110.6, "diameter": 10.1, "maiden_flight": "1967-11-09", "launch_cost": null, "launch_mass": 2970, "leo_capacity": 140000, "gto_capacity": null, "to_thrust": 35100, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/saturn2520v_image_20190222030036.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Saturn_V", "total_launch_count": 13, "consecutive_successful_launches": 11, "successful_launches": 12, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 843, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/843/?format=api", "mission_end": "1969-11-19T06:54:35Z", "destination": "Lunar Surface", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 588, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/588/?format=api", "name": "LM Intrepid", "serial_number": "LM-6", "is_placeholder": false, "in_space": false, "time_in_space": "P4DT20H28M19S", "time_docked": "P4DT10H50M20S", "flights_count": 2, "mission_ends_count": 2, "status": { "id": 3, "name": "Destroyed" }, "description": "Flown on Apollo 12.\r\n\r\nDescent stage on lunar surface at Ocean of Storms, ascent stage deliberately crashed into Moon.", "spacecraft_config": { "id": 43, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/43/?format=api", "name": "Apollo Lunar Module", "type": { "id": 7, "name": "Lander" }, "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": "Landing on the Moon, Rendezvous in lunar orbit", "history": "First flown in 1969, the LM achieved its historic moment on July 20th, 1969, when the \"Eagle\" landed on the Moon, carrying the first humans to walk on its surface.", "details": "The Apollo Lunar Module was the lunar lander spacecraft that was flown between lunar orbit and the Moon's surface during the United States' Apollo program. It was the first crewed spacecraft to operate exclusively in the airless vacuum of space, and was the first crewed vehicle to land anywhere beyond Earth.", "maiden_flight": "1968-01-22", "height": 7.04, "diameter": 4.22, "human_rated": true, "crew_capacity": 2, "payload_capacity": null, "payload_return_capacity": null, "flight_life": "", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/lunar_module_on_image_20240505074251.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Apollo_Lunar_Module", "info_link": "" } }, "landing": { "id": 1392, "attempt": true, "success": true, "description": "", "downrange_distance": null, "location": { "id": 41, "name": "Apollo 12 landing site", "abbrev": "A12", "description": "Landing site of Apollo 12’s lunar module Intrepid on 19 November 1969.", "location": { "id": 168, "url": "https://ll.thespacedevs.com/2.2.0/location/168/?format=api", "name": "Oceanus Procellarum, Moon", "country_code": "", "description": "Oceanus Procellarum is a vast lunar mare on the western edge of the near side of the Moon.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_apollo_12_landing_site252c_oceanus_procellarum252c_moon_20240813032914.jpg", "timezone_name": "", "total_launch_count": 1, "total_landing_count": 0 }, "successful_landings": 1 }, "type": { "id": 9, "name": "Vertical Landing", "abbrev": "VL", "description": "Vertical landing using engines" } }, "docking_events": [] } }, "mission": { "id": 147, "name": "Apollo 12", "description": "Apollo 12 was the second manned mission to the surface of the moon. The commander of the mission was Charles Conrad, Jr. , the Command Module Pilot was Richard Gordon, Jr. , and the Lunar Module Pilot was Alan Bean. The mission was launched on November 14th, 1969 and the Capsule safely splashed down in the ocean on November 24th, 1969", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 11, "name": "Lunar Orbit", "abbrev": "LO" }, "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": "Launch of Apollo 12 Saturn V and lightning strike on rocket, original NBC TV", "description": "Apollo 12 NBS News coverage of the launch of the Saturn V carrying the second crew of astronauts to land on the Moon. The rocket launched in rain and generat...", "feature_image": "https://i.ytimg.com/vi/ySXVQmIStXc/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=ySXVQmIStXc", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/saturn2520v_image_20190222030036.jpeg", "infographic": null, "program": [ { "id": 4, "url": "https://ll.thespacedevs.com/2.2.0/program/4/?format=api", "name": "Apollo", "description": "The Apollo program was the third United States human spaceflight program carried out by the National Aeronautics and Space Administration (NASA), which succeeded in landing the first humans on the Moon from 1969 to 1972.", "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/apollo_program_20200820200202.png", "start_date": "1966-11-16T00:00:00Z", "end_date": "1972-12-19T19:24:59Z", "info_url": "https://www.nasa.gov/mission_pages/apollo/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Apollo_program", "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 1032, "location_launch_attempt_count": 7, "pad_launch_attempt_count": 6, "agency_launch_attempt_count": 102, "orbital_launch_attempt_count_year": 113, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 3, "agency_launch_attempt_count_year": 5, "pad_turnaround": "P121DT2H50M", "mission_patches": [ { "id": 103, "name": "Apollo 12 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/apollo2520122_mission_patch_20211031042339.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" }
