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/f9dfd932-17e6-423d-b6e4-09576e64a9ac/?format=api
{ "id": "f9dfd932-17e6-423d-b6e4-09576e64a9ac", "url": "https://ll.thespacedevs.com/2.2.0/launch/f9dfd932-17e6-423d-b6e4-09576e64a9ac/?format=api", "slug": "saturn-ib-apollo-5", "flightclub_url": null, "r_spacex_api_id": null, "name": "Saturn IB | Apollo 5", "status": { "id": 3, "name": "Launch Successful", "abbrev": "Success", "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)." }, "last_updated": "2025-02-20T07:08:02Z", "updates": [], "net": "1968-01-22T22:48:09Z", "net_precision": null, "window_end": "1968-01-22T22:48:09Z", "window_start": "1968-01-22T22:48:09Z", "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": 213, "configuration": { "id": 163, "url": "https://ll.thespacedevs.com/2.2.0/config/launcher/163/?format=api", "name": "Saturn IB", "active": false, "reusable": false, "description": "The Saturn IB (pronounced \"one B\", also known as the Uprated Saturn I) was an American launch vehicle commissioned by the National Aeronautics and Space Administration (NASA) for the Apollo program. It replaced the S-IV second stage of the Saturn I with the much more powerful S-IVB, able to launch a partially fueled Apollo Command/Service Module (CSM) or a fully fueled Lunar Module (LM) into low Earth orbit for early flight tests before the larger Saturn V needed for lunar flight was ready.", "family": "Saturn", "full_name": "Saturn IB", "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": "IB", "alias": "", "min_stage": 2, "max_stage": 2, "length": 43.2, "diameter": 6.61, "maiden_flight": "1966-02-26", "launch_cost": null, "launch_mass": 590, "leo_capacity": 21000, "gto_capacity": null, "to_thrust": 7100, "apogee": null, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/saturn2520ib_image_20190222030046.jpeg", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Saturn_IB", "total_launch_count": 10, "consecutive_successful_launches": 6, "successful_launches": 9, "failed_launches": 1, "pending_launches": 0, "attempted_landings": 0, "successful_landings": 0, "failed_landings": 0, "consecutive_successful_landings": 0 }, "launcher_stage": [], "spacecraft_stage": { "id": 834, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/834/?format=api", "mission_end": "1968-01-23T09:59:00Z", "destination": "LEO", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 584, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/584/?format=api", "name": "Apollo 5 LM", "serial_number": "LM-1", "is_placeholder": false, "in_space": false, "time_in_space": "PT11H10M51S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 3, "name": "Destroyed" }, "description": "Flown on Apollo 5", "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": 1358, "attempt": false, "success": null, "description": "Reentered Earths Atmosphere.", "downrange_distance": null, "location": null, "type": { "id": 7, "name": "Destructive Reentry", "abbrev": "ATM", "description": "Spacecraft burned up in the atmosphere" } }, "docking_events": [] } }, "mission": { "id": 460, "name": "Apollo 5", "description": "The Apollo 5 mission tested the Lunar Module in a space environment, in particular its descent and ascent engine systems, and its ability to separate the ascent and descent stages. The descent engine would become the first throttleable rocket engine fired in space.", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" }, "agencies": [], "info_urls": [], "vid_urls": [] }, "pad": { "id": 19, "url": "https://ll.thespacedevs.com/2.2.0/pad/19/?format=api", "agency_id": null, "name": "Launch Complex 34", "description": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Cape_Canaveral_Air_Force_Station_Launch_Complex_34", "map_url": "https://www.google.com/maps?q=28.521811,-80.56113", "latitude": "28.521811", "longitude": "-80.56113", "location": { "id": 12, "url": "https://ll.thespacedevs.com/2.2.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "description": "Cape Canaveral Space Force Station (CCSFS) is an installation of the United States Space Force's Space Launch Delta 45, located on Cape Canaveral in Brevard County, Florida.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "timezone_name": "America/New_York", "total_launch_count": 1015, "total_landing_count": 62 }, "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_19_20200803143428.jpg", "total_launch_count": 9, "orbital_launch_attempt_count": 3 }, "infoURLs": [ { "priority": 0, "source": "en.wikipedia.org", "title": "Apollo 5 - Wikipedia", "description": "Uncrewed first test flight of the Apollo Lunar Module\n\nApollo 5 (launched January 22, 1968), also known as AS-204, was the uncrewed first flight of the Apollo Lunar Module (LM) that would later carry astronauts to the surface of the Moon. The Saturn IB rocket bearing the LM lifted off from Cape Kenn...", "feature_image": null, "url": "https://en.wikipedia.org/wiki/Apollo_5", "type": null, "language": null } ], "vidURLs": [ { "priority": 10, "source": "youtube.com", "publisher": "TheConquestofSpace", "title": "The Apollo 5 Mission", "description": "Think you knew everything about the Apollo program and the Lunar Module? Watch this vintage NASA documentary on the flight of Apollo 5. This flight was a test of an unmanned Lunar Module in earth orbi...", "feature_image": "https://i.ytimg.com/vi/9519e2ctqPQ/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=9519e2ctqPQ", "type": { "id": 1, "name": "Official Webcast" }, "language": { "id": 1, "name": "English", "code": "en" }, "start_time": "2011-03-16T04:59:42Z", "end_time": "2011-03-16T05:14:43Z" } ], "webcast_live": false, "timeline": [], "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/saturn2520ib_image_20190222030046.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": 795, "location_launch_attempt_count": 216, "pad_launch_attempt_count": 8, "agency_launch_attempt_count": 91, "orbital_launch_attempt_count_year": 7, "location_launch_attempt_count_year": 2, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P359DT23H16M50S", "mission_patches": [], "type": "detailed" }
