Spacecraft List
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', 'is_placeholder', 'in_space' Example - /2.2.0/spacecraft/?in_space=true
SEARCH EXAMPLE: Example - /2.2.0/spacecraft/?search=Dragon
ORDERING: Fields - 'id', 'time_in_space', 'time_docked', 'flights_count', 'mission_ends_count' Example - /2.2.0/spacecraft/?ordering=id
GET /2.2.0/spacecraft/?format=api&offset=580&ordering=-mission_ends_count
{ "count": 601, "next": "https://lldev.thespacedevs.com/2.2.0/spacecraft/?format=api&limit=10&offset=590&ordering=-mission_ends_count", "previous": "https://lldev.thespacedevs.com/2.2.0/spacecraft/?format=api&limit=10&offset=570&ordering=-mission_ends_count", "results": [ { "id": 452, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/452/?format=api", "name": "Crew Dragon", "serial_number": "TBD", "is_placeholder": true, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 1, "name": "Active" }, "description": "The specific spacecraft for this launch is currently unknown.", "spacecraft_config": { "id": 6, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/6/?format=api", "name": "Crew Dragon 2", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 121, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" }, "in_use": true, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/spacex_dm-2_cre_image_20200504065311.jpeg" } }, { "id": 612, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/612/?format=api", "name": "Soyuz MS-28", "serial_number": "11F732 #759", "is_placeholder": false, "in_space": true, "time_in_space": "P9DT16H48M51S", "time_docked": "P9DT13H42M48S", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 1, "name": "Active" }, "description": "Soyuz capsule for the MS-28 mission to the ISS.", "spacecraft_config": { "id": 38, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/38/?format=api", "name": "Soyuz MS", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 63, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "in_use": true, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg" } }, { "id": 470, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/470/?format=api", "name": "Ship 20", "serial_number": "S20", "is_placeholder": false, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 2, "name": "Retired" }, "description": "Used for ground testing alongside Booster 4. Ship 20 is now on display at the Starbase Rocket Garden.", "spacecraft_config": { "id": 26, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/26/?format=api", "name": "Starship V1", "type": { "id": 6, "name": "Reuseable Upper Stage" }, "agency": { "id": 121, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" }, "in_use": false, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg" } }, { "id": 622, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/622/?format=api", "name": "Progress MS-32", "serial_number": "MS-32 (No.462)", "is_placeholder": false, "in_space": true, "time_in_space": "P86DT10H22M45S", "time_docked": "P84DT8H53M51S", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "Progress MS-32 is a Progress spacecraft used by Roscosmos to resupply the International Space Station (ISS).", "spacecraft_config": { "id": 33, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/33/?format=api", "name": "Progress-MS", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "id": 63, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "in_use": true, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/progress-ms_image_20231219150735.jpeg" } }, { "id": 275, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/275/?format=api", "name": "Tesla Roadster", "serial_number": "TSLA 10", "is_placeholder": false, "in_space": true, "time_in_space": "P2860DT5H29M25S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "Elon Musk's Tesla Roadster is an electric sports car that served as the dummy payload for the February 2018 Falcon Heavy test flight and became an artificial satellite of the Sun. \"Starman\", a mannequin dressed in a spacesuit, occupies the driver's seat. The car and rocket are products of Tesla and SpaceX, respectively, both companies founded by Elon Musk. The 2008-model Roadster was previously used by Musk for commuting to work, and is the only production car in space.\r\n\r\nThe car, mounted on the rocket's second stage, acquired enough velocity to escape Earth's gravity and enter an elliptical heliocentric orbit crossing the orbit of Mars. The orbit reaches a maximum distance from the Sun at aphelion of 1.66 astronomical units (au). During the early portion of the voyage outside the Earth's atmosphere, live video was transmitted back to the mission control center and live-streamed for slightly over four hours.", "spacecraft_config": { "id": 20, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/20/?format=api", "name": "Tesla Roadster", "type": { "id": 5, "name": "Mass Simulator" }, "agency": { "id": 121, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" }, "in_use": false, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/tesla2520roadster_image_20190307220553.jpg" } }, { "id": 598, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/598/?format=api", "name": "Soyuz MS-27", "serial_number": "11F732 #758", "is_placeholder": false, "in_space": true, "time_in_space": "P242DT20H29M28S", "time_docked": "P242DT17H19M", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "Spacecraft launched to the ISS in March 2025.", "spacecraft_config": { "id": 38, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/38/?format=api", "name": "Soyuz MS", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 63, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/63/?format=api", "name": "Russian Federal Space Agency (ROSCOSMOS)", "type": "Government" }, "in_use": true, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg" } }, { "id": 608, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/608/?format=api", "name": "Unknown RSS", "serial_number": "TBD", "is_placeholder": false, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 1, "name": "Active" }, "description": "The specific spacecraft for this launch is currently unknown.", "spacecraft_config": { "id": 21, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/21/?format=api", "name": "Crew Capsule 2.0", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 141, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/141/?format=api", "name": "Blue Origin", "type": "Commercial" }, "in_use": true, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/crew2520capsule25202.0_image_20190309095011.jpeg" } }, { "id": 609, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/609/?format=api", "name": "Shenzhou 20", "serial_number": "20", "is_placeholder": false, "in_space": true, "time_in_space": "P226DT16H59M16S", "time_docked": "P226DT10H27M47S", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 1, "name": "Active" }, "description": "Spacecraft used to launch 3 astronauts on the 9th crewed mission to the Chinese Space Station.", "spacecraft_config": { "id": 2, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/2/?format=api", "name": "Shenzhou", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 17, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "in_use": true, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg" } }, { "id": 615, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/615/?format=api", "name": "Ship 36", "serial_number": "S36", "is_placeholder": false, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 3, "name": "Destroyed" }, "description": "Ship 36 (S36) was the 2nd stage vehicle that was planned to be used for the 10th Starship flight test. It was the 4th \"Block 2\" Starship spacecraft with lengthened propellant tanks and forward flaps with a new design, among other enhancements. Destroyed in an explosion while attempting a static fire on the ground on 18 June 2025.", "spacecraft_config": { "id": 45, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/45/?format=api", "name": "Starship V2", "type": { "id": 6, "name": "Reuseable Upper Stage" }, "agency": { "id": 121, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" }, "in_use": false, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/starship_during_image_20250824175325.jpg" } }, { "id": 541, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/541/?format=api", "name": "Orion 004", "serial_number": "004", "is_placeholder": false, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 5, "name": "Under construction" }, "description": "Orion spacecraft used for Artemis 3.", "spacecraft_config": { "id": 4, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/4/?format=api", "name": "Orion", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 44, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/44/?format=api", "name": "National Aeronautics and Space Administration", "type": "Government" }, "in_use": true, "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/orion_image_20231118102035.jpeg" } } ] }
