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://ll.thespacedevs.com/2.2.0/spacecraft/?format=api&limit=10&offset=590&ordering=-mission_ends_count", "previous": "https://ll.thespacedevs.com/2.2.0/spacecraft/?format=api&limit=10&offset=570&ordering=-mission_ends_count", "results": [ { "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": "P237DT9H29M20S", "time_docked": "P235DT7H37M", "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": 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": 611, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/611/?format=api", "name": "Tianzhou-9", "serial_number": "9", "is_placeholder": false, "in_space": true, "time_in_space": "P226DT7H27M34S", "time_docked": "P226DT4H9M57S", "flights_count": 1, "mission_ends_count": 0, "status": { "id": 4, "name": "Single Use" }, "description": "Ninth operational Tianzhou spacecraft.", "spacecraft_config": { "id": 25, "url": "https://ll.thespacedevs.com/2.2.0/config/spacecraft/25/?format=api", "name": "Tianzhou", "type": { "id": 4, "name": "Cargo Resupply" }, "agency": { "id": 88, "url": "https://ll.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": 547, "url": "https://ll.thespacedevs.com/2.2.0/spacecraft/547/?format=api", "name": "Gaganyaan G1", "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": "First operational Gaganyaan capsule.", "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": 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": 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": 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": 541, "url": "https://ll.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://ll.thespacedevs.com/2.2.0/config/spacecraft/4/?format=api", "name": "Orion", "type": { "id": 2, "name": "Capsule" }, "agency": { "id": 44, "url": "https://ll.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": 612, "url": "https://ll.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": "P90DT19H34M", "time_docked": "P90DT16H27M58S", "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://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": 275, "url": "https://ll.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": "P2941DT8H10M38S", "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://ll.thespacedevs.com/2.2.0/config/spacecraft/20/?format=api", "name": "Tesla Roadster", "type": { "id": 5, "name": "Mass Simulator" }, "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/tesla2520roadster_image_20190307220553.jpg" } } ] }
