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/ae6a6b3b-69ae-49c0-90d3-a055e2d82747/?format=api
{ "id": "ae6a6b3b-69ae-49c0-90d3-a055e2d82747", "url": "https://ll.thespacedevs.com/2.2.0/launch/ae6a6b3b-69ae-49c0-90d3-a055e2d82747/?format=api", "slug": "saturn-v-apollo-13", "flightclub_url": null, "r_spacex_api_id": null, "name": "Saturn V | Apollo 13", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2024-06-15T14:36:51Z", "updates": [], "net": "1970-04-11T19:13:03Z", "net_precision": { "id": 0, "name": "Second", "abbrev": "SEC", "description": "The T-0 is accurate to the second." }, "window_end": "1970-04-11T19:13:03Z", "window_start": "1970-04-11T19:13:03Z", "probability": null, "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": 227, "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": 844, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/844/?format=api", "mission_end": "1970-04-17T16:43:00Z", "destination": "Cislunar Orbit", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 589, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/589/?format=api", "name": "LM Aquarius", "serial_number": "LM-7", "is_placeholder": false, "in_space": false, "time_in_space": "P5DT21H29M57S", "time_docked": "P5DT18H10M52S", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 3, "name": "Destroyed" }, "description": "Flown on Apollo 13\r\n\r\nRe-entered Earth's atmosphere.", "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": 1393, "attempt": false, "success": null, "description": "", "downrange_distance": null, "location": null, "type": { "id": 7, "name": "Destructive Reentry", "abbrev": "ATM", "description": "Spacecraft burned up in the atmosphere" } }, "docking_events": [] } }, "mission": { "id": 148, "name": "Apollo 13", "description": "Apollo 13 was the famous mission that never made it to the moon's surface because of a catastrophic malfunction on board, but the astronauts did return safely to the Earth. The mission was commanded by Jim Lovell, the Command Module Pilot was Jack Swigert, and the Lunar Module Pilot was Fred Haise. The mission launched on April 11th, 1970 and the Capsule safely landed in the ocean on April 17th, 1970.", "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": 265, "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": 207, "orbital_launch_attempt_count": 206 }, "infoURLs": [], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "Launch of Apollo 13 (CBS)", "description": "The launch of Apollo 13 - This is the CBS coverage of the event.", "feature_image": "https://i.ytimg.com/vi/7C3NAj4jCb0/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=7C3NAj4jCb0", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Launch of Apollo 13 (NASA Footage)", "description": "The launch of Apollo 13 - 11th April 1970. Onboard are astronauts Jim Lovell (CDR), Jack Swigert (CMP) and Fred Haise (LMP).The video and audio footage is di...", "feature_image": "https://i.ytimg.com/vi/eN31_PyaN14/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=eN31_PyaN14", "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": 1077, "location_launch_attempt_count": 8, "pad_launch_attempt_count": 7, "agency_launch_attempt_count": 104, "orbital_launch_attempt_count_year": 31, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P148DT2H51M3S", "mission_patches": [ { "id": 104, "name": "Apollo 13 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/apollo2520132_mission_patch_20211031042347.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" }
