GET

Spacecraft List

Modes

Levels of detail in the response - normal, detailed

Example - /spacecraft/?mode=detailed

Filters

Parameters - in_space, is_placeholder, name, spacecraft_config, status

Example - /spacecraft/?is_placeholder=True

Fields searched - name, spacecraft_config__name

Example - /spacecraft/?search=Endeavour

Ordering

Fields - flights_count, id, mission_ends_count, time_docked, time_in_space

Example - /spacecraft/?ordering=-flights_count

Number of results

Use limit to control the number of objects in the response (max 100)

Example - /spacecraft/?limit=2

Format

Switch to JSON output - /spacecraft/?format=json

Help

Find all the FAQs and support links on the documentation homepage - lldev.thespacedevs.com/docs

GET /2.3.0/spacecraft/?format=api&offset=600&ordering=id
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 601,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/spacecraft/?format=api&limit=10&offset=590&ordering=id",
    "results": [
        {
            "response_mode": "normal",
            "id": 624,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/624/?format=api",
            "name": "Shenzhou 22",
            "serial_number": "22",
            "is_placeholder": false,
            "image": {
                "id": 1926,
                "name": "[AUTO] Shenzhou - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194145.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "in_space": true,
            "time_in_space": "P11DT22H5M6S",
            "time_docked": "P11DT18H26M51S",
            "flights_count": 1,
            "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": {
                "response_mode": "normal",
                "id": 2,
                "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/2/?format=api",
                "name": "Shenzhou",
                "type": {
                    "id": 2,
                    "name": "Capsule"
                },
                "agency": {
                    "response_mode": "list",
                    "id": 17,
                    "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api",
                    "name": "China National Space Administration",
                    "abbrev": "CNSA",
                    "type": {
                        "id": 1,
                        "name": "Government"
                    }
                },
                "family": [],
                "in_use": true,
                "image": {
                    "id": 1926,
                    "name": "[AUTO] Shenzhou - image",
                    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg",
                    "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194145.jpeg",
                    "credit": null,
                    "license": {
                        "id": 1,
                        "name": "Unknown",
                        "priority": 9,
                        "link": null
                    },
                    "single_use": true,
                    "variants": []
                }
            },
            "fastest_turnaround": null
        }
    ]
}