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/ad53f165-a118-43a6-ad46-6021accdaabd/?format=api
{ "id": "ad53f165-a118-43a6-ad46-6021accdaabd", "url": "https://ll.thespacedevs.com/2.0.0/launch/ad53f165-a118-43a6-ad46-6021accdaabd/?format=api", "launch_library_id": null, "slug": "falcon-heavy-goes-u", "name": "Falcon Heavy | GOES-U", "status": { "id": 3, "name": "Success" }, "net": "2024-06-25T21:26:00Z", "window_end": "2024-06-25T23:16:00Z", "window_start": "2024-06-25T21:16:00Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": 70, "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": 510, "consecutive_successful_launches": 33, "successful_launches": 496, "failed_launches": 14, "pending_launches": 117, "consecutive_successful_landings": 79, "successful_landings": 457, "failed_landings": 26, "attempted_landings": 482, "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": 7449, "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": 510, "consecutive_successful_launches": 33, "successful_launches": 496, "failed_launches": 14, "pending_launches": 117, "consecutive_successful_landings": 79, "successful_landings": 457, "failed_landings": 26, "attempted_landings": 482, "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": 425, "type": "Strap-On Booster", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 148, "url": "https://ll.thespacedevs.com/2.0.0/launcher/148/?format=api", "details": "Falcon 9 booster that started out as a Falcon Heavy side booster flown during the GOES-U mission.\r\n\r\nWritten off on 3 March 2025 after safely landing aboard JRTI due to post-landing aft end fire damaging one of the landing legs and tipping it overboard.", "flight_proven": true, "serial_number": "B1086", "status": "lost", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/b1072_and_b1086_image_20240626195649.jpeg", "successful_landings": 5, "attempted_landings": 5, "flights": 5, "last_launch_date": "2025-03-03T02:24:00Z", "first_launch_date": "2024-06-25T21:26:00Z" }, "landing": { "id": 1307, "attempt": true, "success": true, "description": "The Falcon Heavy side booster B1086 has landed back at the launch site after its 1st 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": 1023, "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": null, "turn_around_time_days": null, "previous_flight": null }, { "id": 406, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 147, "url": "https://ll.thespacedevs.com/2.0.0/launcher/147/?format=api", "details": "Falcon Heavy core booster expended during the GOES-U mission.", "flight_proven": false, "serial_number": "B1087", "status": "expended", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/b1086_liftoff__image_20240626195956.jpeg", "successful_landings": 0, "attempted_landings": 0, "flights": 1, "last_launch_date": "2024-06-25T21:26:00Z", "first_launch_date": "2024-06-25T21:26:00Z" }, "landing": { "id": 1305, "attempt": false, "success": null, "description": "Core booster B1087 was expended on 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": 426, "type": "Strap-On Booster", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 111, "url": "https://ll.thespacedevs.com/2.0.0/launcher/111/?format=api", "details": "Falcon Heavy side booster first flown during the GOES-U mission.", "flight_proven": true, "serial_number": "B1072", "status": "active", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/b1072_and_b1086_image_20240626195649.jpeg", "successful_landings": 1, "attempted_landings": 1, "flights": 1, "last_launch_date": "2024-06-25T21:26:00Z", "first_launch_date": "2024-06-25T21:26:00Z" }, "landing": { "id": 1306, "attempt": true, "success": true, "description": "The Falcon Heavy side booster B1072 has landed back at the launch site after its 1st 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": 1023, "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": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": null }, "mission": { "id": 5841, "launch_library_id": null, "name": "GOES-U", "description": "The Geostationary Operational Environmental Satellite-U (GOES-U) is the fourth of the next generation of geostationary weather satellites, known as the GOES-R series. The four satellites of the series provide advanced imaging with increased spatial resolution and faster coverage for more accurate forecasts, real-time mapping of lightning activity, and improved monitoring of solar activity. Once GOES-U reaches orbit, it will be renamed GOES-19.", "launch_designator": null, "type": "Earth Science", "orbit": { "id": 2, "name": "Geostationary Transfer Orbit", "abbrev": "GTO" } }, "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": 10, "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=goes-u" } ], "vidURLs": [ { "priority": 10, "title": "Geostationary Operational Environmental Satellite-U (GOES-U) Launch", "description": "Watch the launch of the GOES-U weather-observing and environmental monitoring satellite on a SpaceX Falcon Heavy rocket! The National Oceanic and Atmospheric...", "feature_image": "https://i.ytimg.com/vi/F4HH_fL7QVk/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=F4HH_fL7QVk" }, { "priority": 11, "title": "Watch live: SpaceX Falcon Heavy launches GOES-U weather satellite from NASA's Kennedy Space Center", "description": "Watch live coverage as SpaceX launches a Falcon Heavy rocket carrying the GOES-U weather satellite for NASA and NOAA. Liftoff from launch complex 39A at NASA...", "feature_image": "https://i.ytimg.com/vi/4SBxb5-S8HM/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=4SBxb5-S8HM" }, { "priority": 12, "title": "SpaceX Falcon Heavy Launches GOES-U", "description": "GOES-U will provide advanced imagery and atmospheric measurements of Earth’s weather, oceans, and environment, as well as real-time mapping of total lightnin...", "feature_image": "https://i.ytimg.com/vi/7kMlfbo1lts/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=7kMlfbo1lts" } ], "webcast_live": false, "image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/fh_liftoff_from_image_20240626200232.jpeg", "infographic": null, "program": [ { "id": 37, "url": "https://ll.thespacedevs.com/2.0.0/program/37/?format=api", "name": "Geostationary Operational Environmental Satellite", "description": "The Geostationary Operational Environmental Satellite (GOES), operated by the United States' National Oceanic and Atmospheric Administration (NOAA)'s National Environmental Satellite, Data, and Information Service division, supports weather forecasting, severe storm tracking, and meteorology research", "agencies": [ { "id": 44, "url": "https://ll.thespacedevs.com/2.0.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, { "id": 210, "url": "https://ll.thespacedevs.com/2.0.0/agencies/210/?format=api", "name": "National Oceanic and Atmospheric Administration", "type": "Government" } ], "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/goes-u_render_image_20240623151909.jpg", "start_date": "1975-10-16T22:40:00Z", "end_date": null, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Geostationary_Operational_Environmental_Satellite" } ], "orbital_launch_attempt_count": 6711, "location_launch_attempt_count": 239, "pad_launch_attempt_count": 181, "agency_launch_attempt_count": 378, "orbital_launch_attempt_count_year": 122, "location_launch_attempt_count_year": 13, "pad_launch_attempt_count_year": 13, "agency_launch_attempt_count_year": 67 }
