Launch Instance
API endpoint that returns all Launch objects or a single launch.
EXAMPLE - /launch/
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'
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.0.0/launch/66133437-db31-4098-8e3e-cf34c8125f9b/?format=api
{ "id": "66133437-db31-4098-8e3e-cf34c8125f9b", "url": "https://ll.thespacedevs.com/2.0.0/launch/66133437-db31-4098-8e3e-cf34c8125f9b/?format=api", "launch_library_id": 2046, "slug": "falcon-heavy-psyche", "name": "Falcon Heavy | Psyche", "status": { "id": 3, "name": "Success" }, "net": "2023-10-13T14:19:43Z", "window_end": "2023-10-13T14:19:43Z", "window_start": "2023-10-13T14:19:43Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": 85, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 121, "url": "https://ll.thespacedevs.com/2.0.0/agencies/121/?format=api", "name": "SpaceX", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "SpX", "description": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.", "administrator": "CEO: Elon Musk", "founding_year": "2002", "launchers": "Falcon | Starship", "spacecraft": "Dragon", "launch_library_url": null, "total_launch_count": 511, "consecutive_successful_launches": 34, "successful_launches": 497, "failed_launches": 14, "pending_launches": 117, "consecutive_successful_landings": 80, "successful_landings": 458, "failed_landings": 26, "attempted_landings": 483, "info_url": "http://www.spacex.com/", "wiki_url": "http://en.wikipedia.org/wiki/SpaceX", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_image_20190207032501.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_nation_20230531064544.jpg" }, "rocket": { "id": 2691, "configuration": { "id": 161, "launch_library_id": 58, "url": "https://ll.thespacedevs.com/2.0.0/config/launcher/161/?format=api", "name": "Falcon Heavy", "description": "The Falcon Heavy is a variant of the Falcon 9 full thrust launch vehicle and consists of a standard Falcon 9 rocket core, with two additional boosters derived from the Falcon 9 first stage.", "family": "Falcon", "full_name": "Falcon Heavy", "manufacturer": { "id": 121, "url": "https://ll.thespacedevs.com/2.0.0/agencies/121/?format=api", "name": "SpaceX", "featured": true, "type": "Commercial", "country_code": "USA", "abbrev": "SpX", "description": "Space Exploration Technologies Corp., known as SpaceX, is an American aerospace manufacturer and space transport services company headquartered in Hawthorne, California. It was founded in 2002 by entrepreneur Elon Musk with the goal of reducing space transportation costs and enabling the colonization of Mars. SpaceX operates from many pads, on the East Coast of the US they operate from SLC-40 at Cape Canaveral Space Force Station and historic LC-39A at Kennedy Space Center. They also operate from SLC-4E at Vandenberg Space Force Base, California, usually for polar launches. Another launch site is being developed at Boca Chica, Texas.", "administrator": "CEO: Elon Musk", "founding_year": "2002", "launchers": "Falcon | Starship", "spacecraft": "Dragon", "launch_library_url": null, "total_launch_count": 511, "consecutive_successful_launches": 34, "successful_launches": 497, "failed_launches": 14, "pending_launches": 117, "consecutive_successful_landings": 80, "successful_landings": 458, "failed_landings": 26, "attempted_landings": 483, "info_url": "http://www.spacex.com/", "wiki_url": "http://en.wikipedia.org/wiki/SpaceX", "logo_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_image_20190207032501.jpeg", "nation_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/spacex_nation_20230531064544.jpg" }, "program": [], "variant": "Heavy", "alias": "", "min_stage": 3, "max_stage": 3, "length": 70.0, "diameter": 12.2, "maiden_flight": "2018-02-06", "launch_mass": 1400, "leo_capacity": 63800, "gto_capacity": 26700, "to_thrust": 22819, "apogee": 200, "vehicle_range": null, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon_heavy_image_20220129192819.jpeg", "info_url": "https://www.spacex.com/vehicles/falcon-heavy/index.html", "wiki_url": "https://en.wikipedia.org/wiki/Falcon_Heavy", "total_launch_count": 11, "consecutive_successful_launches": 11, "successful_launches": 11, "failed_launches": 0, "pending_launches": 11 }, "launcher_stage": [ { "id": 239, "type": "Strap-On Booster", "reused": true, "launcher_flight_number": 4, "launcher": { "id": 85, "url": "https://ll.thespacedevs.com/2.0.0/launcher/85/?format=api", "details": "Side booster paired with B1065, launched 3 USSF missions, EchoStar 24 and the Psyche mission before expended during launch of Europa Clipper.", "flight_proven": true, "serial_number": "B1064", "status": "expended", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/85_image_20221102112709.jpeg", "successful_landings": 5, "attempted_landings": 5, "flights": 6, "last_launch_date": "2024-10-14T16:06:00Z", "first_launch_date": "2022-11-01T13:41:00Z" }, "landing": { "id": 267, "attempt": true, "success": true, "description": "B1064 has landed on LZ-1 after its 4th flight.", "location": { "id": 4, "name": "Landing Zone 1", "abbrev": "LZ-1", "description": "LZ-1 Pad located at Cape Canaveral Space Force Station at the previous LC-13", "location": { "id": 12, "url": "https://ll.thespacedevs.com/2.0.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "total_launch_count": 1024, "total_landing_count": 64 }, "successful_landings": 51 }, "type": { "id": 2, "name": "Return to Launch Site", "abbrev": "RTLS", "description": "A return to launch site usually means that after stage separation the booster flips and does a burn back towards the launch site, landing near where it initially launched from." } }, "previous_flight_date": "2023-07-29T03:04:00Z", "turn_around_time_days": 76, "previous_flight": { "id": "72491a20-315d-4aea-b6df-d1202930bd60", "name": "Falcon Heavy | EchoStar 24/Jupiter-3" } }, { "id": 238, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 121, "url": "https://ll.thespacedevs.com/2.0.0/launcher/121/?format=api", "details": "Falcon Heavy core booster expended during the Psyche mission.", "flight_proven": true, "serial_number": "B1079", "status": "expended", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/121_image_20231014091824.jpg", "successful_landings": 0, "attempted_landings": 0, "flights": 1, "last_launch_date": "2023-10-13T14:19:43Z", "first_launch_date": "2023-10-13T14:19:43Z" }, "landing": { "id": 266, "attempt": false, "success": null, "description": "B1079 was expended after its first flight.", "location": { "id": 6, "name": "Atlantic Ocean", "abbrev": "ATL", "description": "Atlantic Ocean", "location": null, "successful_landings": 37 }, "type": { "id": 8, "name": "Expended", "abbrev": "EXP", "description": "Vehicle did not perform any landing operations after launch" } }, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null }, { "id": 240, "type": "Strap-On Booster", "reused": true, "launcher_flight_number": 4, "launcher": { "id": 86, "url": "https://ll.thespacedevs.com/2.0.0/launcher/86/?format=api", "details": "Side booster paired with B1064, launched 3 USSF missions, EchoStar 24 and the Psyche mission before expended during launch of Europa Clipper.", "flight_proven": true, "serial_number": "B1065", "status": "expended", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/85_image_20221102112709.jpeg", "successful_landings": 5, "attempted_landings": 5, "flights": 6, "last_launch_date": "2024-10-14T16:06:00Z", "first_launch_date": "2022-11-01T13:41:00Z" }, "landing": { "id": 268, "attempt": true, "success": true, "description": "B1065 has landed on LZ-2 after its 4th flight.", "location": { "id": 5, "name": "Landing Zone 2", "abbrev": "LZ-2", "description": "LZ-2 Pad located at Cape Canaveral Space Force Station at the previous LC-13. Directly next to LZ-1", "location": { "id": 12, "url": "https://ll.thespacedevs.com/2.0.0/location/12/?format=api", "name": "Cape Canaveral SFS, FL, USA", "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_12_20200803142519.jpg", "total_launch_count": 1024, "total_landing_count": 64 }, "successful_landings": 12 }, "type": { "id": 2, "name": "Return to Launch Site", "abbrev": "RTLS", "description": "A return to launch site usually means that after stage separation the booster flips and does a burn back towards the launch site, landing near where it initially launched from." } }, "previous_flight_date": "2023-07-29T03:04:00Z", "turn_around_time_days": 76, "previous_flight": { "id": "72491a20-315d-4aea-b6df-d1202930bd60", "name": "Falcon Heavy | EchoStar 24/Jupiter-3" } } ], "spacecraft_stage": null }, "mission": { "id": 1098, "launch_library_id": 1295, "name": "Psyche", "description": "Psyche is a NASA interplanetary mission to visit the main belt asteroid of the same name, 16 Psyche. Spacecraft will take 4 years and one Mars flyby to reach the asteroid, which is of particular interest due to being comprised mostly of iron and nickel. Psyche is theorized to be a remnant of an early planet's core, and may offer insights into how solar system formed and evolved. The mission is led by Arizona State University, with NASA JPL being responsible for mission management and operations.", "launch_designator": null, "type": "Planetary Science", "orbit": { "id": 6, "name": "Heliocentric N/A", "abbrev": "Helio-N/A" } }, "pad": { "id": 87, "url": "https://ll.thespacedevs.com/2.0.0/pad/87/?format=api", "agency_id": 121, "name": "Launch Complex 39A", "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.0.0/location/27/?format=api", "name": "Kennedy Space Center, FL, USA", "country_code": "USA", "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_27_20200803142447.jpg", "total_launch_count": 265, "total_landing_count": 0 }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_87_20200803143537.jpg", "total_launch_count": 207 }, "infoURLs": [ { "priority": 9, "title": "SpaceX", "description": "SpaceX designs, manufactures and launches advanced rockets and spacecraft. The company was founded in 2002 to revolutionize space technology, with the ultimate goal of enabling people to live on other planets.", "feature_image": null, "url": "https://www.spacex.com/launches/mission/?missionId=psyche" }, { "priority": 10, "title": "A Mission to a Metal World", "description": "The Psyche mission will explore, for the first time ever, an asteroid made not of rock or ice, but of metal. The mission will investigate planet formation.", "feature_image": null, "url": "https://psyche.asu.edu/" } ], "vidURLs": [ { "priority": 10, "title": "Psyche Launches to a Metal Asteroid (Official NASA Broadcast)", "description": "Watch the Psyche spacecraft launch from NASA’s Kennedy Space Center in Florida on a SpaceX Falcon Heavy rocket. NASA and SpaceX are now targeting launch at 1...", "feature_image": "https://i.ytimg.com/vi/npIDMxrzm_o/maxresdefault_live.jpg", "url": "https://www.youtube.com/watch?v=npIDMxrzm_o" } ], "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/falcon2520heav_image_20231014091714.jpeg", "infographic": null, "program": [ { "id": 33, "url": "https://ll.thespacedevs.com/2.0.0/program/33/?format=api", "name": "Discovery Program", "description": "The Discovery Program is a series of Solar System exploration missions funded by the U.S. National Aeronautics and Space Administration (NASA) through its Planetary Missions Program Office. The cost of each mission is capped at a lower level than missions from NASA's New Frontiers or Flagship Programs. As a result, Discovery missions tend to be more focused on a specific scientific goal rather than serving a general purpose.", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.0.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/discovery2520p_program_20231231122246.jpeg", "start_date": "1990-01-01T00:00:00Z", "end_date": null, "info_url": "https://www.nasa.gov/planetarymissions/discovery-program/", "wiki_url": "https://en.wikipedia.org/wiki/Discovery_Program" } ], "orbital_launch_attempt_count": 6534, "location_launch_attempt_count": 224, "pad_launch_attempt_count": 166, "agency_launch_attempt_count": 286, "orbital_launch_attempt_count_year": 166, "location_launch_attempt_count_year": 11, "pad_launch_attempt_count_year": 11, "agency_launch_attempt_count_year": 73 }
