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/9a2f71b1-27c8-43f9-9d7c-7d8c434371e4/?format=api
{ "id": "9a2f71b1-27c8-43f9-9d7c-7d8c434371e4", "url": "https://ll.thespacedevs.com/2.2.0/launch/9a2f71b1-27c8-43f9-9d7c-7d8c434371e4/?format=api", "slug": "saturn-v-apollo-4", "flightclub_url": null, "r_spacex_api_id": null, "name": "Saturn V | Apollo 4", "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-05-05T08:33:57Z", "updates": [], "net": "1967-11-09T12:00:01Z", "net_precision": null, "window_end": "1967-11-09T12:00:01Z", "window_start": "1967-11-09T12:00:01Z", "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": "Administrator: Bill Nelson", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 135, "consecutive_successful_launches": 11, "successful_launches": 115, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_nation_20230803040809.jpg" }, "rocket": { "id": 212, "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": "Administrator: Bill Nelson", "founding_year": "1958", "launchers": "Space Shuttle | SLS", "spacecraft": "Orion", "launch_library_url": null, "total_launch_count": 135, "consecutive_successful_launches": 11, "successful_launches": 115, "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://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_logo_20190207032448.png", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/national2520aeronautics2520and2520space2520administration_image_20190207032448.jpeg", "nation_url": "https://spacelaunchnow-prod-east.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://spacelaunchnow-prod-east.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://spacelaunchnow-prod-east.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": 23, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/23/?format=api", "mission_end": "1967-11-09T20:37:00Z", "destination": "Hyperbolic Earth Orbit (simulating a return from the Moon)", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 23, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/23/?format=api", "name": "Apollo CSM-017", "serial_number": "CSM-017", "is_placeholder": false, "in_space": false, "time_in_space": "PT8H36M59S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "CSM-017 was an Apollo Command & Service Module used in the Apollo 4 mission.", "spacecraft_config": { "id": 10, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/10/?format=api", "name": "Apollo Command/Service Module", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 999, "url": "https://ll.thespacedevs.com/2.2.0/agencies/999/?format=api", "name": "North American Aviation", "featured": false, "type": "Commercial", "country_code": "USA", "abbrev": "", "description": "North American Aviation (NAA) was a major American aerospace manufacturer, responsible for a number of historic aircraft, including the T-6 Texan trainer, the P-51 Mustang fighter, the B-25 Mitchell bomber, the F-86 Sabre jet fighter, the X-15 rocket plane, and the XB-70, as well as Apollo command and service module, the second stage of the Saturn V rocket, the Space Shuttle orbiter and the B-1 Lancer.", "administrator": null, "founding_year": "1928", "launchers": "North American X-15", "spacecraft": "", "parent": "Boeing", "image_url": null, "logo_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/north2520american2520aviation_logo_20200711032022.png" }, "in_use": false, "capability": "Cargo and Human Transportation to Lunar Orbit", "history": "The Apollo Command/Service Module (CSM) was one of two principal components of the United States Apollo spacecraft, used for the Apollo program which landed astronauts on the Moon between 1969 and 1972.", "details": "The Apollo Command/Service Module (CSM) was one of two principal components of the United States Apollo spacecraft, used for the Apollo program which landed astronauts on the Moon between 1969 and 1972. The CSM functioned as a mother ship which carried a crew of three astronauts and the second Apollo spacecraft, the Lunar Module, to lunar orbit, and brought the astronauts back to Earth. It consisted of two parts: the conical Command Module, a cabin that housed the crew and carried equipment needed for atmospheric reentry and splashdown; and the cylindrical Service Module which provided propulsion, electrical power and storage for various consumables required during a mission. An umbilical connection transferred power and consumables between the two modules. Just before reentry of the Command Module on the return home, the umbilical connection was severed and the Service Module was cast off and allowed to burn up in the atmosphere.", "maiden_flight": "1966-02-26", "height": 11.0, "diameter": 3.9, "human_rated": true, "crew_capacity": 3, "payload_capacity": 1050, "payload_return_capacity": null, "flight_life": "14 days", "image_url": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/images/apollo2520command2fservice2520module_image_20190207032507.jpeg", "nation_url": null, "wiki_link": "https://en.wikipedia.org/wiki/Apollo_Command/Service_Module", "info_link": "" } }, "landing": { "id": 374, "attempt": true, "success": true, "description": "The Apollo spacecraft successfully splashed down in the Pacific Ocean.", "downrange_distance": null, "location": { "id": 18, "name": "Pacific Ocean", "abbrev": "PAC", "description": "Pacific Ocean", "location": null, "successful_landings": 3 }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PL", "description": "Unpowered landing using parachute(s)." } }, "docking_events": [] } }, "mission": { "id": 781, "name": "Apollo 4", "description": "Apollo 4 was an \"all-up\" test, meaning all rocket stages and spacecraft were fully functional on the initial flight, a first for NASA. It was the first time the S-IC first stage and S-II second stage flew. It also demonstrated the S-IVB third stage's first in-flight restart. The mission used a Block I Command Service Module (CSM) modified to test several key Block II revisions, including its heat shield at simulated lunar-return velocity and angle.", "launch_designator": null, "type": "Human Exploration", "orbit": { "id": 0, "name": "Elliptical Orbit", "abbrev": "Elliptical" }, "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": null, "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": "", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/location_27_20200803142447.jpg", "timezone_name": "America/New_York", "total_launch_count": 237, "total_landing_count": 0 }, "country_code": "USA", "map_image": "https://spacelaunchnow-prod-east.nyc3.digitaloceanspaces.com/media/launch_images/pad_87_20200803143537.jpg", "total_launch_count": 179, "orbital_launch_attempt_count": 178 }, "infoURLs": [ { "priority": 0, "source": "en.wikipedia.org", "title": "Apollo 4 - Wikipedia", "description": "First test flight of the Apollo Saturn V rocket\n\nApollo 4 (November 9, 1967), also known as SA-501, was the uncrewed first test flight of the Saturn V launch vehicle, the rocket that eventually took astronauts to the Moon. The space vehicle was assembled in the Vehicle Assembly Building, and was the...", "feature_image": null, "url": "https://en.wikipedia.org/wiki/Apollo_4", "type": null, "language": null } ], "vidURLs": [ { "priority": 0, "source": null, "publisher": null, "title": "APOLLO 4: THE FIRST GIANT STEPS SATURN V ROCKET HISTORIC NASA FILM 71442", "description": "Support Our Channel : https://www.patreon.com/PeriscopeFilm This historic NASA film profiles the Apollo 4 mission (also known as AS-501). This was the first,...", "feature_image": "https://i.ytimg.com/vi/n8FmR3OL36k/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=n8FmR3OL36k", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Launch of Apollo 4 first Saturn V as seen LIVE on CBS w/ Walter Cronkite", "description": "The first launch of the Saturn V rocket from Kennedy Space Center. This is footage from CBS News with Walter Cronkite. This is the famous video of him exclai...", "feature_image": "https://i.ytimg.com/vi/1uoVfZpx5dY/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=1uoVfZpx5dY", "type": null, "language": null, "start_time": null, "end_time": null }, { "priority": 0, "source": null, "publisher": null, "title": "Apollo 4: \"The first flight of a Saturn V launch vehicle\" HD, Kennedy Space Center, November 9, 1967", "description": "NASA movie restored by Jeff Quitney, from Jeff Quitney YouTube website: https://www.youtube.com/user/webdev17/featured , the best documentary library. Apollo...", "feature_image": "https://i.ytimg.com/vi/SM2KWCMrOYw/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=SM2KWCMrOYw", "type": null, "language": null, "start_time": null, "end_time": null } ], "webcast_live": false, "timeline": [], "image": "https://spacelaunchnow-prod-east.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://spacelaunchnow-prod-east.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": 772, "location_launch_attempt_count": 1, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 90, "orbital_launch_attempt_count_year": 125, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 4, "pad_turnaround": "P0D", "mission_patches": [], "type": "detailed" }
