Spacecraft Instance
API endpoint that allows Spacecrafts to be viewed. A Spacecraft is a physically manufactured instance of a Spacecraft Configuration
GET: Return a list of all the existing spacecraft.
FILTERS: Parameters - 'name', 'status', 'spacecraft_config' Example - /2.0.0/spacecraft/?status=Active
SEARCH EXAMPLE: Example - /2.0.0/spacecraft/?search=Dragon
ORDERING: Fields - 'id' Example - /2.0.0/spacecraft/?order=id
GET /2.0.0/spacecraft/635/?format=api
{ "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" }, "flights": [ { "id": 922, "url": "https://lldev.thespacedevs.com/2.0.0/spacecraft/flight/922/?format=api", "destination": "Low Earth Orbit", "mission_end": null, "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", "type": "Commercial" }, "in_use": true, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_during_image_20250824175325.jpg" } }, "launch": { "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", "type": "Commercial" }, "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", "family": "Starship", "full_name": "Starship V3", "variant": "V3" } }, "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 }, "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" } ] } } ] }
