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=10&ordering=mission_ends_count
{ "count": 601, "next": "https://ll.thespacedevs.com/2.2.0/spacecraft/?format=api&limit=10&offset=20&ordering=mission_ends_count", "previous": "https://ll.thespacedevs.com/2.2.0/spacecraft/?format=api&limit=10&ordering=mission_ends_count", "results": [ { "id": 616, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/616/?format=api", "name": "Soyuz MS-29", "serial_number": "11F732 #760", "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": "Soyuz capsule for the MS-29 mission to the ISS.", "spacecraft_config": { "id": 38, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/38/?format=api", "name": "Soyuz MS", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 63, "url": "https://ll.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" } }, { "id": 470, "url": "https://ll.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://ll.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://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" }, "in_use": false, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_image_20231116184708.jpeg" } }, { "id": 619, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/619/?format=api", "name": "Cygnus CRS NG-23 (S.S. William “Willie” C. McCool)", "serial_number": null, "is_placeholder": false, "in_space": true, "time_in_space": "P65DT3H52M26S", "time_docked": "P61DT14H40M14S", "flights_count": 1, "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://ll.thespacedevs.com/2.2.0/config/spacecraft/19/?format=api", "name": "Cygnus Enhanced", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "id": 257, "url": "https://ll.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": 621, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/621/?format=api", "name": "Ship 39", "serial_number": "S39", "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": "First V3 Starship planned to fly on flight 12.", "spacecraft_config": { "id": 46, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/46/?format=api", "name": "Starship V3", "type": { "id": 6, "name": "Reuseable Upper Stage" }, "agency": { "id": 121, "url": "https://ll.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_during_image_20250824175325.jpg" } }, { "id": 624, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/624/?format=api", "name": "Shenzhou 22", "serial_number": "22", "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": "Spacecraft to be launched without crew to replace Shenzhou 20 that was damaged by orbital debris on the descent module porthole window, and thus deemed unsuitable for crew re-entry. The spacecraft will later return three Chinese astronauts on the 10th flight to the Chinese Space Station back to Earth, after launching on Shenzhou 21.", "spacecraft_config": { "id": 2, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/2/?format=api", "name": "Shenzhou", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 17, "url": "https://ll.thespacedevs.com/2.2.0/agencies/17/?format=api", "name": "China National Space Administration", "type": "Government" }, "in_use": true, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg" } }, { "id": 452, "url": "https://ll.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://ll.thespacedevs.com/2.2.0/config/spacecraft/6/?format=api", "name": "Crew Dragon 2", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 121, "url": "https://ll.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": 608, "url": "https://ll.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://ll.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://ll.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": 617, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/617/?format=api", "name": "Progress MS-31", "serial_number": "MS-31 (No.461)", "is_placeholder": false, "in_space": true, "time_in_space": "P138DT6H31M33S", "time_docked": "P136DT4H39M13S", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "Progress MS-31 is a Progress spacecraft used by Roscosmos to resupply the International Space Station (ISS).", "spacecraft_config": { "id": 33, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/33/?format=api", "name": "Progress-MS", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "id": 63, "url": "https://ll.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/progress-ms_image_20231219150735.jpeg" } }, { "id": 615, "url": "https://ll.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://ll.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://ll.thespacedevs.com/2.2.0/agencies/121/?format=api", "name": "SpaceX", "type": "Commercial" }, "in_use": false, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starship_during_image_20250824175325.jpg" } }, { "id": 569, "url": "https://ll.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://ll.thespacedevs.com/2.2.0/config/spacecraft/7/?format=api", "name": "Cargo Dragon 2", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 121, "url": "https://ll.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" } } ] }
