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/421/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "response_mode": "detailed",
    "id": 421,
    "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/421/?format=api",
    "name": "Shenzhou 4",
    "serial_number": "4",
    "is_placeholder": false,
    "image": {
        "id": 1926,
        "name": "[AUTO] Shenzhou - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg",
        "thumbnail_url": "https://thespacedevs-prod.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": false,
    "time_in_space": "P6DT18H35M56S",
    "time_docked": "P0D",
    "flights_count": 1,
    "mission_ends_count": 1,
    "status": {
        "id": 4,
        "name": "Single Use"
    },
    "description": "The spacecraft was equipped for a manned flight, even featuring a sleeping bag, food, and medication. The windows were constructed of a new material that was designed to stay clear even after reentry to allow an astronaut to confirm that the parachutes have deployed properly. It was said that the spacecraft flown on Shenzhou 4 had no major differences to that used on Shenzhou 5. It flew with the ability for manual control and emergency landing, systems needed for a manned flight. A week before the launch, astronauts trained in the spacecraft to familiarise themselves with its systems.",
    "spacecraft_config": {
        "response_mode": "detailed",
        "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": "normal",
            "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"
            },
            "featured": true,
            "country": [
                {
                    "id": 6,
                    "name": "China",
                    "alpha_2_code": "CN",
                    "alpha_3_code": "CHN",
                    "nationality_name": "Chinese",
                    "nationality_name_composed": "Sino"
                }
            ],
            "description": "The China National Space Administration (CNSA) is the national space agency of the People's Republic of China. It is responsible for the national space program and for planning and development of space activities. CNSA and China Aerospace Corporation (CASC) assumed the authority over space development efforts previously held by the Ministry of Aerospace Industry. The CNSA has many launch sites around China with their orbital sites located in Jiuquan, Xichang, Taiyuan and Wenchang.",
            "administrator": "Administrator: Tang Dengjie",
            "founding_year": 1993,
            "launchers": "",
            "spacecraft": "Shenzhou",
            "parent": null,
            "image": {
                "id": 9,
                "name": "[AUTO] China National Space Administration - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_image_20190207032431.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184601.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "logo": {
                "id": 125,
                "name": "[AUTO] China National Space Administration - logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_logo_20190207032431.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184936.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "social_logo": {
                "id": 51,
                "name": "[AUTO] China National Space Administration - social_logo",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_nation_20190602114400.png",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184747.png",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            }
        },
        "family": [],
        "in_use": true,
        "image": {
            "id": 1926,
            "name": "[AUTO] Shenzhou - image",
            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/shenzhou_image_20190207032522.jpeg",
            "thumbnail_url": "https://thespacedevs-prod.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": []
        },
        "capability": "Chinese crewed spaceflight program.",
        "history": "Shenzhou is a spacecraft used to support the Chinese manned spaceflight program and to carry crew to the Tiangong Space Station. Its design resembles the Russian Soyuz spacecraft, but it is larger in size and all-new in construction. The first launch was on November 19, 1999 and the first manned launch was on October 15, 2003.",
        "details": "The Shenzhou spacecraft resembles the Soyuz, although it is longer, with a larger habitable volume. It features a powered service module like the Soyuz, and prior to Shenzhou 8 its orbital module was capable of autonomous flight. \r\n\r\nThe aft service module contains life support and other equipment required for the functioning of Shenzhou.",
        "maiden_flight": "1999-11-19",
        "height": 9.25,
        "diameter": 2.8,
        "human_rated": true,
        "crew_capacity": 3,
        "payload_capacity": null,
        "payload_return_capacity": null,
        "flight_life": "200 day design life.",
        "wiki_link": "https://en.wikipedia.org/wiki/Shenzhou_(spacecraft)",
        "info_link": "",
        "spacecraft_flown": 19,
        "total_launch_count": 19,
        "successful_launches": 19,
        "failed_launches": 0,
        "attempted_landings": 18,
        "successful_landings": 17,
        "failed_landings": 1,
        "fastest_turnaround": null
    },
    "fastest_turnaround": null,
    "flights": []
}