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/0f867f0c-5422-4d44-93b8-d7faaae7019b/?format=api
{ "id": "0f867f0c-5422-4d44-93b8-d7faaae7019b", "url": "https://lldev.thespacedevs.com/2.0.0/launch/0f867f0c-5422-4d44-93b8-d7faaae7019b/?format=api", "launch_library_id": null, "slug": "starship-starlink-group-31-2-starship-flight-15", "name": "Starship | Starlink Group 31-2 (Starship Flight 15)", "status": { "id": 2, "name": "TBD" }, "net": "2026-11-13T22:45:00Z", "window_end": "2026-11-14T00:00:00Z", "window_start": "2026-11-13T22:45:00Z", "inhold": false, "tbdtime": false, "tbddate": false, "probability": null, "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": 745, "consecutive_successful_launches": 230, "successful_launches": 730, "failed_launches": 15, "pending_launches": 136, "consecutive_successful_landings": 39, "successful_landings": 690, "failed_landings": 29, "attempted_landings": 718, "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": 9138, "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": 745, "consecutive_successful_launches": 230, "successful_launches": 730, "failed_launches": 15, "pending_launches": 136, "consecutive_successful_landings": 39, "successful_landings": 690, "failed_landings": 29, "attempted_landings": 718, "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": 3, "consecutive_successful_launches": 3, "successful_launches": 3, "failed_launches": 0, "pending_launches": 0 }, "launcher_stage": [ { "id": 1045, "type": "Core", "reused": false, "launcher_flight_number": 1, "launcher": { "id": 262, "url": "https://lldev.thespacedevs.com/2.0.0/launcher/262/?format=api", "details": "Fourth Block 3 Super Heavy booster to fly with various enhancements including Raptor 3 engines, integrated interstage and 3 grid fins instead of 4 used. To be used on the 15th Starship flight test, the 2nd Starship flight to deploy satellites into stable Low Earth Orbit. It is the first Starship V3 booster to attempt landing back on its launch pad.", "flight_proven": false, "serial_number": "Booster 22", "status": "active", "image_url": null, "successful_landings": 0, "attempted_landings": 0, "flights": 0, "last_launch_date": null, "first_launch_date": null }, "landing": { "id": 1978, "attempt": true, "success": null, "description": "The Super Heavy Booster 22 will attempt to return the launch site at Starbase.", "location": { "id": 53, "name": "Orbital Launch Mount B", "abbrev": "OLM-B", "description": "", "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": 23, "total_landing_count": 13 }, "successful_landings": 0 }, "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": { "id": 922, "url": "https://lldev.thespacedevs.com/2.0.0/spacecraft/flight/922/?format=api", "mission_end": null, "destination": "Low Earth Orbit", "launch_crew": [], "onboard_crew": [], "landing_crew": [], "spacecraft": { "id": 635, "url": "https://lldev.thespacedevs.com/2.0.0/spacecraft/635/?format=api", "name": "Ship 42", "serial_number": "S42", "status": { "id": 1, "name": "Active" }, "description": "Fourth V3 Starship to fly with various enhancements, to be used on the 15th Starship test flight, the 2nd Starship flight to deploy satellites into stable Low Earth Orbit. It is the first ever Starship 2nd stage to attempt returning to its launch pad.", "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": 7737, "launch_library_id": null, "name": "Starlink Group 31-2 (Starship Flight 15)", "description": "15th test flight of the two-stage Starship launch vehicle and 4th flight of Starship V3. Second Starship flight to deploy satellites (a group of Starlink satellites known as Starlink Group 31-2) into stable Low Earth Orbit and first ever to attempt returning the Starship 2nd stage back to the launch site.\r\n\r\nThe ship is expected to fly at an altitude approximately 275 km above Earth and complete approximately 14 orbits around the planet for more than 22 hours, with the ship expected to attempt returning back to Starbase, Texas on its launch pad by pad arms catching.\r\n\r\nThe booster’s primary test objective on Flight 15 will be executing a successful launch, ascent, stage separation, boostback burn, and landing by pad arms catching. This will also be the 1st Starship V3 booster to attempt returning to its launch site.\r\n\r\nStarship will deliver 26 Starlink V3 satellites to orbit for the second time, which aim to greatly expand the network's capacity and user speeds. Each Starlink V3 satellite will add 1 Tbps of capacity to the constellation. 3 of the satellites have been modified with a suite of cameras to scan Starship’s heatshield and transmit imagery down to operators.", "launch_designator": null, "type": "Communications", "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO" } }, "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": 23, "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": 3 }, "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-15" } ], "vidURLs": [], "webcast_live": false, "image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_on_the_image_20260724044615.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" }, { "id": 25, "url": "https://lldev.thespacedevs.com/2.0.0/program/25/?format=api", "name": "Starlink", "description": "Starlink is a satellite internet constellation operated by American aerospace company SpaceX", "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/starlink_program_20231228154508.jpeg", "start_date": "2018-02-22T14:17:00Z", "end_date": null, "info_url": "https://starlink.com", "wiki_url": "https://en.wikipedia.org/wiki/Starlink" } ], "orbital_launch_attempt_count": 7438, "location_launch_attempt_count": 24, "pad_launch_attempt_count": 4, "agency_launch_attempt_count": 746, "orbital_launch_attempt_count_year": 265, "location_launch_attempt_count_year": 4, "pad_launch_attempt_count_year": 4, "agency_launch_attempt_count_year": 127 }
