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/5aad41ac-9656-471b-a367-81a42f3a1d86/?format=api
{ "id": "5aad41ac-9656-471b-a367-81a42f3a1d86", "url": "https://ll.thespacedevs.com/2.2.0/launch/5aad41ac-9656-471b-a367-81a42f3a1d86/?format=api", "slug": "saturn-v-apollo-14", "flightclub_url": null, "r_spacex_api_id": null, "name": "Saturn V | Apollo 14", "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:44:59Z", "updates": [], "net": "1971-01-31T21:03:02Z", "net_precision": null, "window_end": "1971-01-31T21:03:02Z", "window_start": "1971-01-31T21:03:02Z", "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": 230, "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": 845, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/flight/845/?format=api", "mission_end": "1971-02-05T09:18:11Z", "destination": "Lunar Surface", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 590, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/590/?format=api", "name": "LM Antares", "serial_number": "LM-8", "is_placeholder": false, "in_space": false, "time_in_space": "P4DT16H14M27S", "time_docked": "P4DT5H4M53S", "flights_count": 2, "mission_ends_count": 2, "status": { "id": 3, "name": "Destroyed" }, "description": "Flown on Apollo 14.\r\n\r\nDescent stage on lunar surface at Fra Mauro, 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": 1394, "attempt": true, "success": true, "description": "Successful lunar landing of Apollo 14 in the Fra Mauro formation.", "downrange_distance": null, "location": { "id": 42, "name": "Apollo 14 landing site", "abbrev": "A14", "description": "Landing site of Apollo 14’s lunar module Antares on 5 February 1971.", "location": { "id": 169, "url": "https://ll.thespacedevs.com/2.2.0/location/169/?format=api", "name": "Fra Mauro Formation, Moon", "country_code": "", "description": "The Fra Mauro formation (or Fra Mauro Highlands) is a formation on the near side of Earth's Moon that served as the landing site for the American Apollo 14 mission in 1971. It is named after the 80-kilometer-diameter crater Fra Mauro, located within it. The formation, as well as Fra Mauro crater, take their names from a 15th-century Italian monk and mapmaker of the same name.", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_apollo_14_landing_site252c_fra_mauro252c_moon_20240813033131.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": 149, "name": "Apollo 14", "description": "Apollo 14 was the eighth manned mission in the Apollo Program. The third mission to land on the moon. This mission was a two day stay on the lunar surface and carried out two EVAs. Commanded by Alan Shepard, Command Module Pilot Stuart Rossa, and Lunar Module Pilot Edgar Mitchell. During the two lunar EVAs, 42.80 kilograms of moon rock samples was collected.", "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": "CBS News Coverage of The Apollo 14 Launch", "description": "From Sunday January 31st 1971 CBS News Covers The Apollo 14 Launch The 3rd sucessful Moon Landing Mission. With Walter Cronkite and Former Astronant Wally Sc...", "feature_image": "https://i.ytimg.com/vi/Rj8dVdJyj1c/hqdefault.jpg", "url": "https://www.youtube.com/watch?v=Rj8dVdJyj1c", "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": 1179, "location_launch_attempt_count": 9, "pad_launch_attempt_count": 8, "agency_launch_attempt_count": 107, "orbital_launch_attempt_count_year": 8, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 1, "pad_turnaround": "P295DT1H49M59S", "mission_patches": [ { "id": 105, "name": "Apollo 14 Patch", "priority": 10, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/mission_patch_images/apollo2520142_mission_patch_20211031042355.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" }
