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_in_space
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 593,
    "next": "https://lldev.thespacedevs.com/2.2.0/spacecraft/?format=api&limit=10&offset=30&ordering=time_in_space",
    "previous": "https://lldev.thespacedevs.com/2.2.0/spacecraft/?format=api&limit=10&offset=10&ordering=time_in_space",
    "results": [
        {
            "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",
                "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": 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": 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-prod.nyc3.digitaloceanspaces.com/media/images/orion_image_20231118102035.jpeg"
            }
        },
        {
            "id": 489,
            "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/489/?format=api",
            "name": "Soyuz 7K-OK No.1",
            "serial_number": "Soyuz 7K-OK (P) 11F615 #1",
            "is_placeholder": false,
            "in_space": false,
            "time_in_space": "P0D",
            "time_docked": "P0D",
            "flights_count": 1,
            "mission_ends_count": 1,
            "status": {
                "id": 4,
                "name": "Single Use"
            },
            "description": "First generation Soyuz meant to be used for a test flight.",
            "spacecraft_config": {
                "id": 1,
                "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/1/?format=api",
                "name": "Soyuz",
                "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": false,
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_image_20201015191152.jpg"
            }
        },
        {
            "id": 533,
            "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/533/?format=api",
            "name": "Vostok-1K No.4",
            "serial_number": "Vostok-1K No.4",
            "is_placeholder": false,
            "in_space": false,
            "time_in_space": "P0D",
            "time_docked": "P0D",
            "flights_count": 1,
            "mission_ends_count": 1,
            "status": {
                "id": 4,
                "name": "Single Use"
            },
            "description": "Vostok spacecraft used for test flights before the first human spaceflight.",
            "spacecraft_config": {
                "id": 15,
                "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/15/?format=api",
                "name": "Vostok",
                "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": false,
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vostok-3ka_image_20190207032525.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": 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": 547,
            "url": "https://lldev.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://lldev.thespacedevs.com/2.2.0/config/spacecraft/29/?format=api",
                "name": "Gaganyaan",
                "type": {
                    "id": 2,
                    "name": "Capsule"
                },
                "agency": {
                    "id": 1031,
                    "url": "https://lldev.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": 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": 13,
            "url": "https://lldev.thespacedevs.com/2.2.0/spacecraft/13/?format=api",
            "name": "Gemini SC3",
            "serial_number": "3",
            "is_placeholder": false,
            "in_space": false,
            "time_in_space": "P0D",
            "time_docked": "P0D",
            "flights_count": 1,
            "mission_ends_count": 1,
            "status": {
                "id": 4,
                "name": "Single Use"
            },
            "description": "Gemini SC3 is the Gemini capsule used for the Gemini 3 mission launched on March 23, 1965 and piloted by astronaut Virgil Il. \"Gus\" Grissom.",
            "spacecraft_config": {
                "id": 12,
                "url": "https://lldev.thespacedevs.com/2.2.0/config/spacecraft/12/?format=api",
                "name": "Gemini",
                "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": false,
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gemini_image_20190207032517.jpeg"
            }
        }
    ]
}