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/ed83366c-872c-4484-97c1-bc74832304fc/?format=api
{ "id": "ed83366c-872c-4484-97c1-bc74832304fc", "url": "https://lldev.thespacedevs.com/2.0.0/launch/ed83366c-872c-4484-97c1-bc74832304fc/?format=api", "launch_library_id": null, "slug": "starship-flight-12", "name": "Starship | Flight 12", "status": { "id": 3, "name": "Success" }, "net": "2026-05-22T22:30:24Z", "window_end": "2026-05-23T00:00:00Z", "window_start": "2026-05-22T22:30:00Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": 85, "holdreason": "", "failreason": "", "hashtag": null, "launch_service_provider": { "id": 121, "url": "https://lldev.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": 679, "consecutive_successful_launches": 164, "successful_launches": 664, "failed_launches": 15, "pending_launches": 122, "consecutive_successful_landings": 0, "successful_landings": 624, "failed_landings": 28, "attempted_landings": 651, "info_url": "https://www.spacex.com/", "wiki_url": "https://en.wikipedia.org/wiki/SpaceX", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/falcon_9_image_20230807133459.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_social_l_image_20260407054626.jpg" }, "rocket": { "id": 8708, "configuration": { "id": 522, "launch_library_id": null, "url": "https://lldev.thespacedevs.com/2.0.0/config/launcher/522/?format=api", "name": "Starship", "description": "Third development version of the Starship reusable two-stage super heavy-lift launch vehicle.", "family": "Starship", "full_name": "Starship V3", "manufacturer": { "id": 121, "url": "https://lldev.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": 679, "consecutive_successful_launches": 164, "successful_launches": 664, "failed_launches": 15, "pending_launches": 122, "consecutive_successful_landings": 0, "successful_landings": 624, "failed_landings": 28, "attempted_landings": 651, "info_url": "https://www.spacex.com/", "wiki_url": "https://en.wikipedia.org/wiki/SpaceX", "logo_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_logo_20220826094919.png", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/falcon_9_image_20230807133459.jpeg", "nation_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_social_l_image_20260407054626.jpg" }, "program": [ { "id": 1, "url": "https://lldev.thespacedevs.com/2.0.0/program/1/?format=api", "name": "SpaceX Starship", "description": "The SpaceX Starship is a fully reusable super heavy-lift launch vehicle under development by SpaceX since 2012, as a self-funded private spaceflight project. The second stage of the Starship — is designed as a long-duration cargo and passenger-carrying spacecraft. It is expected to be initially used without any booster stage at all, as part of an extensive development program to prove out launch-and-landing and iterate on a variety of design details, particularly with respect to the vehicle's atmospheric reentry.", "agencies": [ { "id": 121, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } ], "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_on_the_image_20250111100520.jpg", "start_date": "2019-03-01T05:00:00Z", "end_date": null, "info_url": "https://www.spacex.com/vehicles/starship/", "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starship" } ], "variant": "V3", "alias": "", "min_stage": 2, "max_stage": 2, "length": 124.4, "diameter": 9.0, "maiden_flight": "2026-05-22", "launch_mass": 5250, "leo_capacity": 100000, "gto_capacity": null, "to_thrust": 80807, "apogee": null, "vehicle_range": null, "image_url": null, "info_url": "https://www.spacex.com/vehicles/starship", "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starship#Block_3", "total_launch_count": 1, "consecutive_successful_launches": 1, "successful_launches": 1, "failed_launches": 0, "pending_launches": 1 }, "launcher_stage": [ { "id": 801, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 243, "url": "https://lldev.thespacedevs.com/2.0.0/launcher/243/?format=api", "details": "First Block 3 Super Heavy booster to fly with various enhancements including Raptor 3 engines, integrated interstage and 3 grid fins instead of 4 used. Used on the 12th Starship flight test, replacing Booster 18 written off during ground testing in November 2025. It was lost after stage separation, having completed an off-nominal boostback burn with fewer engines than planned.", "flight_proven": false, "serial_number": "Booster 19", "status": "destroyed", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_during_image_20260523090008.jpg", "successful_landings": 0, "attempted_landings": 1, "flights": 1, "last_launch_date": "2026-05-22T22:30:24Z", "first_launch_date": "2026-05-22T22:30:24Z" }, "landing": { "id": 1859, "attempt": true, "success": false, "description": "The Super Heavy Booster 19 was lost after stage separation, having performed an off-nominal boostback burn with fewer engines than planned.", "location": { "id": 16, "name": "Gulf of Mexico", "abbrev": "GOM", "description": "Gulf of Mexico", "location": null, "successful_landings": 18 }, "type": { "id": 3, "name": "Ocean", "abbrev": "Ocean", "description": "No recovery attempt" } }, "previous_flight_date": null, "turn_around_time_days": null, "previous_flight": null } ], "spacecraft_stage": { "id": 895, "url": "https://lldev.thespacedevs.com/2.0.0/spacecraft/flight/895/?format=api", "mission_end": "2026-05-22T23:36:59Z", "destination": "Suborbital", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 621, "url": "https://lldev.thespacedevs.com/2.0.0/spacecraft/621/?format=api", "name": "Ship 39", "serial_number": "S39", "status": { "id": 3, "name": "Destroyed" }, "description": "First V3 Starship, that flew on the 12th Starship test flight. Despite the loss of a Raptor Vacuum engine at ignition, it performed an extended ascent burn, reached a valid trajectory, and successfully reentered the atmosphere to splash down softly on target in the Indian Ocean. Lost in an explosion just after the soft splashdown.", "spacecraft_config": { "id": 46, "url": "https://lldev.thespacedevs.com/2.0.0/config/spacecraft/46/?format=api", "name": "Starship V3", "type": { "id": 6, "name": "Reuseable Upper Stage" }, "agency": { "id": 121, "url": "https://lldev.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", "parent": null, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/falcon_9_image_20230807133459.jpeg" }, "in_use": true, "capability": "More than 100 tons to Earth orbit", "history": "The third-generation Starship upper stage will be introduced on flight 12.", "details": "Third-generation second stage of the two-stage Starship super heavy-lift launch vehicle.", "maiden_flight": "2026-05-22", "height": 52.1, "diameter": 9.0, "human_rated": false, "crew_capacity": null, "payload_capacity": null, "flight_life": "Unknown at this stage", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_during_image_20250824175325.jpg", "nation_url": null, "wiki_link": "", "info_link": "https://www.spacex.com/vehicles/starship" } }, "docking_events": [] } }, "mission": { "id": 7301, "launch_library_id": null, "name": "Flight 12", "description": "12th test flight of the two-stage Starship launch vehicle. Maiden Flight of Starship V3.\r\n\r\nThe flight test’s primary goal will be to demonstrate each of these new pieces in the flight environment for the first time, with each element of the Starship architecture featuring significant redesigns to enable full and rapid reuse that incorporate learnings from years of development and test.\r\n\r\nThe Starship upper stage will target multiple in-space and reentry objectives, including a payload deployment of 20 Starlink simulators, similar in size to next-generation Starlink V3 satellites, and two specially modified Starlink satellites. The two modified satellites will test hardware planned for Starlink V3 and will attempt to scan Starship’s heat shield and transmit imagery down to operators to test methods of analyzing Starship’s heat shield readiness for return to launch site on future missions. Several tiles on Starship have been painted white to simulate missing tiles and serve as imaging targets in the test. The Starlink simulators will be on the same suborbital trajectory as Starship. A relight of a single Raptor engine while in space is also planned.\r\n\r\nFor Starship entry, a single heat shield tile has been intentionally removed to measure the aerodynamic load differences on adjacent tiles when there is a tile missing. Finally, the ship will perform experimental actions tested on previous flight tests, including a maneuver to intentionally stress the structural limits of the vehicle’s rear flaps and a dynamic banking maneuver to mimic the trajectory that future missions returning to Starbase will fly.", "launch_designator": null, "type": "Test Flight", "orbit": { "id": 15, "name": "Suborbital", "abbrev": "Sub" } }, "pad": { "id": 235, "url": "https://lldev.thespacedevs.com/2.0.0/pad/235/?format=api", "agency_id": 121, "name": "Orbital Launch Pad 2", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starbase#Launch_site_(Orbital_Launch_Mount_(Pad_1_and_2))", "map_url": "https://www.google.com/maps?q=25.996770,-97.157990", "latitude": "25.99677", "longitude": "-97.15799", "location": { "id": 143, "url": "https://lldev.thespacedevs.com/2.0.0/location/143/?format=api", "name": "SpaceX Starbase, TX, USA", "country_code": "USA", "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_143_20200803142438.jpg", "total_launch_count": 21, "total_landing_count": 13 }, "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_orbital_launch_mount_b_20241126031254.jpg", "total_launch_count": 1 }, "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/starship-flight-12" } ], "vidURLs": [ { "priority": 7, "title": "SpaceX - Starship - Starship Test Flight 12 - Pad 2 - Starbase, Texas - May 22, 2026", "description": "Launch Date: May 22, 2026 (CDT)\nLaunch Time: 5:30 p.m. CDT, 6:30 p.m. EDT, 2230 UTC (May 23, 00:30 CEST)\nLaunch Window: Open until 7:00 p.m. CDT\nStatus: Successful lift-off, successful hot staging. Super Heavy Booster lost 3 Raptor engines during lift-off. Boostback burn was to short, so an uncontrolled \"splash-down\" in the Gulf of Mexico. Starship lost one Vacuum Raptor-3 engine, but operates nominal. 22 Starlink Demo satellites deployed. No Raptor re-ignition test in space was performed. Starship heat-shield operated very well during re-entry, did the belly-flip and made a splashdown controlled upright in the Indian Ocean, west of Australia. A lot of milestones have been reached successfully with Flight Test 12. Next ahead! \n\nLaunch Provider: SpaceX\nLauncher System: Starship-Super H...", "feature_image": "https://i.ytimg.com/vi/OT_ZXZUrUcU/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=OT_ZXZUrUcU" }, { "priority": 8, "title": "Watch Live: SpaceX Starship launches on 12th test flight", "description": "Watch live as SpaceX debuts the latest version of its revolutionary Starship launcher on the 12th test flight for the program. Liftoff of the Version 3 integrated Starship vehicle from a new launch pad at Starbase in Texas is scheduled during a launch window that opens at 5:30 p.m. CDT / 6:30 p.m. EDT / 2230 UTC on Friday, May 22.\n\nThe mission will see splashdowns of the Super Heavy booster (Booster 19) in the Gulf of Mexico and the Starship upper stage (Ship 39) in the Indian Ocean.\n\nThe Starship upper stage will deploy 20 Starlink simulators, similar in size to next-generation Starlink V3 satellites, and two specially modified Starlink satellites that will attempt to beam back imagery of Starship's thermal tiles.\n\nOur live coverage, hosted by Will Robinson-Smith, will begin about tw...", "feature_image": "https://i.ytimg.com/vi/U4alF1JasLo/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=U4alF1JasLo" }, { "priority": 9, "title": "SpaceX Starship Flight 12 - Launch & Landing - LAUNCH STREAM", "description": "Leading up to NSF's Starship Flight 12 attempt 2 launch broadcast, NSF will go live with over six hours of commentary as we stakeout Starship's 12th flight. We will answer questions, observe the ongoing activity at Starbase, and provide you with everything you need to know for Starship Flight 12.\n\nLaunch Window: May 20th from 5:30PM to 7PM CDT (22:30-00:00 UTC)\nCurrent T0: May 20th at 5:30PM CDT (22:30 UTC).\n\nMission: Starship's twelfth integrated flight test. Debut mission for Starship version 3\nLaunch Location: Pad 2, Starbase, Earth\nTarget orbit: Transatmospheric\nBooster: B19-1\nShip: S39-1\nBooster recovery: Expended - Water splashdown on the Gulf\nShip recovery: Expended - Water splashdown on the Indian Ocean\nRocket trajectory: Southeast, passing in between Cuba and the Yucatan Peni...", "feature_image": "https://i.ytimg.com/vi/UfQHy4mVcBo/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=UfQHy4mVcBo" }, { "priority": 10, "title": "Starship's Twelfth Flight Test", "description": "Livestream on X", "feature_image": "https://pbs.twimg.com/media/HI4fjllWgAA48ns.jpg", "url": "https://x.com/i/broadcasts/1pKkOykQRgNKj" }, { "priority": 11, "title": "Watch the first Starship V3 launch for Flight 12!", "description": "SpaceX is about to launch their first V3 Starship and it’s by far the biggest and most radical change to the program to date!\n\n00:00:00 - Intro\n00:01:40 - Q&A\n00:27:00 - Prop Load\n00:30:00 - SpaceX Stream Starts\n00:58:20 - LIFT OFF!\n01:00:50 - Stage Sep\n01:04:50 - Booster Entry\n01:08:00 - SECO\n01:15:20 - Payload Deploy\n01:33:20 - Q&A\n01:45:50 - Re-Entry\n02:04:40 - Starship Splashdown\n\nWant to support what I do? Consider becoming a Patreon supporter for access to exclusive livestreams, our discord channel! - http://patreon.com/everydayastronaut\n\nOr become a YouTube member for some bonus perks as well! - https://www.youtube.com/channel/UC6uKrU_WqJ1R2HMTY3LIx5Q/join\n\nThe best place for all your space merch needs!\nhttps://everydayastronaut.com/shop/\n\nAll music is original! Check it out an...", "feature_image": "https://i.ytimg.com/vi/odWYDx3u8A4/maxresdefault.jpg", "url": "https://www.youtube.com/watch?v=odWYDx3u8A4" } ], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_liftof_image_20260523085855.jpg", "infographic": null, "program": [ { "id": 1, "url": "https://lldev.thespacedevs.com/2.0.0/program/1/?format=api", "name": "SpaceX Starship", "description": "The SpaceX Starship is a fully reusable super heavy-lift launch vehicle under development by SpaceX since 2012, as a self-funded private spaceflight project. The second stage of the Starship — is designed as a long-duration cargo and passenger-carrying spacecraft. It is expected to be initially used without any booster stage at all, as part of an extensive development program to prove out launch-and-landing and iterate on a variety of design details, particularly with respect to the vehicle's atmospheric reentry.", "agencies": [ { "id": 121, "url": "https://lldev.thespacedevs.com/2.0.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" } ], "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_on_the_image_20250111100520.jpg", "start_date": "2019-03-01T05:00:00Z", "end_date": null, "info_url": "https://www.spacex.com/vehicles/starship/", "wiki_url": "https://en.wikipedia.org/wiki/SpaceX_Starship" } ], "orbital_launch_attempt_count": null, "location_launch_attempt_count": 21, "pad_launch_attempt_count": 1, "agency_launch_attempt_count": 679, "orbital_launch_attempt_count_year": null, "location_launch_attempt_count_year": 1, "pad_launch_attempt_count_year": 1, "agency_launch_attempt_count_year": 60 }
