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=20&ordering=time_docked
{ "count": 612, "next": "https://ll.thespacedevs.com/2.2.0/spacecraft/?format=api&limit=10&offset=30&ordering=time_docked", "previous": "https://ll.thespacedevs.com/2.2.0/spacecraft/?format=api&limit=10&offset=10&ordering=time_docked", "results": [ { "id": 205, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/205/?format=api", "name": "Soyuz 2", "serial_number": "Soyuz 7K-OK (P) 11F615 #11", "is_placeholder": false, "in_space": false, "time_in_space": "P2DT22H51M", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Soyuz 2 was a uncrewed Soyuz spacecraft which launched on 28 October 1968 07:51 UTC. It intended to be the target of the Soyuz 3 docking, but it was unsuccessful.", "spacecraft_config": { "id": 1, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/1/?format=api", "name": "Soyuz", "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": false, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_image_20201015191152.jpg" } }, { "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": "PT1H6M35S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 3, "name": "Destroyed" }, "description": "First V3 Starship, that flew on the 12th Starship test flight. Despite the loss of a Raptor Vacuum engine at ignition, it performed an extended ascent burn, reached a valid trajectory, and successfully reentered the atmosphere to splash down softly on target in the Indian Ocean. Lost in an explosion just after the soft splashdown.", "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": 495, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/495/?format=api", "name": "Soyuz 7K-OK No.9", "serial_number": "Soyuz 7K-OK 11F615 #9", "is_placeholder": false, "in_space": false, "time_in_space": "P3DT23H3M", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "First generation Soyuz used for a test flight.", "spacecraft_config": { "id": 1, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/1/?format=api", "name": "Soyuz", "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": false, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_image_20201015191152.jpg" } }, { "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": 496, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/496/?format=api", "name": "Soyuz 7K-T No.33A", "serial_number": "Soyuz 7K-T 11F615A8 #33A", "is_placeholder": false, "in_space": false, "time_in_space": "P5DT9H7M", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Second generation Soyuz used for a test flight.", "spacecraft_config": { "id": 1, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/1/?format=api", "name": "Soyuz", "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": false, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_image_20201015191152.jpg" } }, { "id": 573, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/573/?format=api", "name": "Gaganyaan TV-D1", "serial_number": null, "is_placeholder": false, "in_space": false, "time_in_space": "PT9M", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Capsule used during the inflight abort test.", "spacecraft_config": { "id": 29, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/29/?format=api", "name": "Gaganyaan", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 1031, "url": "https://ll.thespacedevs.com/2.2.0/agencies/1031/?format=api", "name": "Hindustan Aeronautics Limited", "type": "Government" }, "in_use": true, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gaganyaan_image_20231021132705.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": 422, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/422/?format=api", "name": "Shenzhou 5", "serial_number": "5", "is_placeholder": false, "in_space": false, "time_in_space": "PT21H22M45S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Shenzhou 5 was the first human spaceflight mission of the Chinese space program, launched on 15 October 2003. The Shenzhou spacecraft was launched on a Long March 2F launch vehicle.", "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": 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" } }, { "id": 207, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/207/?format=api", "name": "Voskhod-3KV No.3", "serial_number": "Voskhod-3KV No.3", "is_placeholder": false, "in_space": false, "time_in_space": "P1DT17M3S", "time_docked": "P0D", "flights_count": 1, "mission_ends_count": 1, "status": { "id": 4, "name": "Single Use" }, "description": "Voskhod 1 was a Voskhod spacecraft which launched on 12 October 1964 07:30 UTC. It was the seventh manned flight of the Soviet spaceflight program. It launched three cosmonauts for craft testing and science purposes. The crew was Vladimir Komarov,\r\nKonstantin Feoktistov, and Boris Yegorov.", "spacecraft_config": { "id": 16, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/16/?format=api", "name": "Voskhod", "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": false, "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/voskhod_image_20190207032525.png" } } ] }