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=-flights_count
{ "count": 593, "next": "https://lldev.thespacedevs.com/2.2.0/spacecraft/?format=api&limit=10&offset=590&ordering=-flights_count", "previous": "https://lldev.thespacedevs.com/2.2.0/spacecraft/?format=api&limit=10&offset=570&ordering=-flights_count", "results": [ { "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": 26, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/26/?format=api", "name": "Starship", "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": true, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg" } }, { "id": 443, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/443/?format=api", "name": "X-15-2", "serial_number": "56-6671", "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": "Second X-15 experimental rocket plane.", "spacecraft_config": { "id": 13, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/13/?format=api", "name": "North American X-15", "type": { "id": 3, "name": "Spaceplane" }, "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": false, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/north2520american2520x-15_image_20190207032520.jpeg" } }, { "id": 569, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/569/?format=api", "name": "Cargo 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": 7, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/7/?format=api", "name": "Cargo 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-prod.nyc3.digitaloceanspaces.com/media/images/crs-28_dragon_d_image_20230530191602.jpeg" } }, { "id": 611, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/611/?format=api", "name": "Tianzhou-9", "serial_number": "9", "is_placeholder": false, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "Ninth operational Tianzhou spacecraft.", "spacecraft_config": { "id": 25, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/25/?format=api", "name": "Tianzhou", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "id": 88, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/88/?format=api", "name": "China Aerospace Science and Technology Corporation", "type": "Government" }, "in_use": true, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tianzhou_image_20210513100807.jpg" } }, { "id": 572, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/572/?format=api", "name": "Cygnus CRS NG-22", "serial_number": null, "is_placeholder": false, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "This is the twenty-second flight to the ISS by the Cygnus spacecraft under the CRS program and their eleventh under the CRS-2 program. This is also the 18th use of the enhanced size Cygnus.", "spacecraft_config": { "id": 19, "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/19/?format=api", "name": "Cygnus Enhanced", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "id": 257, "url": "https://lldev.thespacedevs.com/2.2.0/agencies/257/?format=api", "name": "Northrop Grumman Space Systems", "type": "Commercial" }, "in_use": true, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/cygnus2520enhanced_image_20190207032513.jpeg" } }, { "id": 223, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/223/?format=api", "name": "DragonFly", "serial_number": "C201", "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": "The DragonFly vehicle was a mockup of the Dragon 2 vehicle used in the pad abort test.", "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-prod.nyc3.digitaloceanspaces.com/media/images/spacex_dm-2_cre_image_20200504065311.jpeg" } }, { "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-prod.nyc3.digitaloceanspaces.com/media/images/spacex_dm-2_cre_image_20200504065311.jpeg" } }, { "id": 540, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/540/?format=api", "name": "Orion 003", "serial_number": "003", "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 2.", "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-prod.nyc3.digitaloceanspaces.com/media/images/orion_image_20231118102035.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-prod.nyc3.digitaloceanspaces.com/media/images/crew2520capsule25202.0_image_20190309095011.jpeg" } }, { "id": 612, "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/612/?format=api", "name": "Soyuz MS-28", "serial_number": null, "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": "Soyuz capsule planned to be used on 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-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg" } } ] }
