Modes

Levels of detail in the response - list, normal, detailed

Example - /astronauts/?mode=list

Filters

Parameters - age, age__gt, age__gte, age__lt, age__lte, agency_ids, date_of_birth, date_of_birth__gt, date_of_birth__gte, date_of_birth__lt, date_of_birth__lte, date_of_death, date_of_death__gt, date_of_death__gte, date_of_death__lt, date_of_death__lte, first_flight, first_flight__gt, first_flight__gte, first_flight__lt, first_flight__lte, flights_count, flights_count__gt, flights_count__gte, flights_count__lt, flights_count__lte, has_flown, in_space, is_human, landings_count, landings_count__gt, landings_count__gte, landings_count__lt, landings_count__lte, last_flight, last_flight__gt, last_flight__gte, last_flight__lt, last_flight__lte, nationality, status_ids, type__id

Example - /astronauts/?has_flown=true

Fields searched - agency__abbrev, agency__name, name, nationality__nationality_name

Example - /astronauts/?search=Pesquet

Ordering

Fields - age, date_of_birth, eva_time, flights_count, id, landings_count, last_flight, name, spacewalks_count, status, time_in_space

Example - /astronauts/?ordering=-time_in_space

Number of results

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

Example - /astronauts/?limit=2

Format

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

Help

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

GET /2.3.0/astronauts/731/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": 731,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/731/?format=api",
    "name": "Cai Xuzhe",
    "status": {
        "id": 1,
        "name": "Active"
    },
    "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"
        }
    },
    "image": {
        "id": 848,
        "name": "[AUTO] Cai Xuzhe - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cai_xuzhe_image_20220604085007.png",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190933.png",
        "credit": null,
        "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
        },
        "single_use": true,
        "variants": []
    },
    "response_mode": "detailed",
    "type": {
        "id": 2,
        "name": "Government"
    },
    "in_space": false,
    "time_in_space": "P364DT18H6M29S",
    "eva_time": "P1DT10H9M",
    "age": 49,
    "date_of_birth": "1976-05-01",
    "date_of_death": null,
    "nationality": [
        {
            "id": 6,
            "name": "China",
            "alpha_2_code": "CN",
            "alpha_3_code": "CHN",
            "nationality_name": "Chinese",
            "nationality_name_composed": "Sino"
        }
    ],
    "bio": "Chinese astronaut from the CNSA Group-2 selection (2010).",
    "wiki": "https://en.wikipedia.org/wiki/Cai_Xuzhe",
    "last_flight": "2024-10-29T20:27:34Z",
    "first_flight": "2022-06-05T02:44:10Z",
    "social_media_links": [],
    "flights_count": 2,
    "landings_count": 2,
    "spacewalks_count": 5,
    "flights": [],
    "landings": [],
    "spacewalks": [
        {
            "response_mode": "list",
            "id": 480,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/480/?format=api",
            "name": "Shenzhou 19 EVA 1a",
            "start": "2024-12-17T04:51:00Z",
            "end": "2024-12-17T13:57:00Z",
            "duration": "PT9H6M",
            "location": "Tiangong Space Station",
            "crew": [
                {
                    "id": 5027,
                    "role": {
                        "id": 33,
                        "role": "EV1",
                        "priority": 0
                    },
                    "astronaut": {
                        "id": 731,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/731/?format=api",
                        "name": "Cai Xuzhe",
                        "status": {
                            "id": 1,
                            "name": "Active"
                        },
                        "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"
                            }
                        },
                        "image": {
                            "id": 848,
                            "name": "[AUTO] Cai Xuzhe - image",
                            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cai_xuzhe_image_20220604085007.png",
                            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190933.png",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "response_mode": "list",
                        "type": {
                            "id": 2,
                            "name": "Government"
                        },
                        "in_space": false,
                        "time_in_space": "P364DT18H6M29S",
                        "eva_time": "P1DT10H9M",
                        "age": 49,
                        "date_of_birth": "1976-05-01",
                        "date_of_death": null,
                        "nationality": [
                            {
                                "id": 6,
                                "name": "China",
                                "alpha_2_code": "CN",
                                "alpha_3_code": "CHN",
                                "nationality_name": "Chinese",
                                "nationality_name_composed": "Sino"
                            }
                        ],
                        "bio": "Chinese astronaut from the CNSA Group-2 selection (2010).",
                        "wiki": "https://en.wikipedia.org/wiki/Cai_Xuzhe",
                        "last_flight": "2024-10-29T20:27:34Z",
                        "first_flight": "2022-06-05T02:44:10Z",
                        "social_media_links": []
                    }
                }
            ]
        },
        {
            "response_mode": "list",
            "id": 483,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/483/?format=api",
            "name": "Shenzhou 19 EVA 2",
            "start": "2025-01-20T08:55:00Z",
            "end": "2025-01-20T17:12:00Z",
            "duration": "PT8H17M",
            "location": "Tiangong Space Station",
            "crew": [
                {
                    "id": 5031,
                    "role": {
                        "id": 33,
                        "role": "EV1",
                        "priority": 0
                    },
                    "astronaut": {
                        "id": 731,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/731/?format=api",
                        "name": "Cai Xuzhe",
                        "status": {
                            "id": 1,
                            "name": "Active"
                        },
                        "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"
                            }
                        },
                        "image": {
                            "id": 848,
                            "name": "[AUTO] Cai Xuzhe - image",
                            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cai_xuzhe_image_20220604085007.png",
                            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190933.png",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "response_mode": "list",
                        "type": {
                            "id": 2,
                            "name": "Government"
                        },
                        "in_space": false,
                        "time_in_space": "P364DT18H6M29S",
                        "eva_time": "P1DT10H9M",
                        "age": 49,
                        "date_of_birth": "1976-05-01",
                        "date_of_death": null,
                        "nationality": [
                            {
                                "id": 6,
                                "name": "China",
                                "alpha_2_code": "CN",
                                "alpha_3_code": "CHN",
                                "nationality_name": "Chinese",
                                "nationality_name_composed": "Sino"
                            }
                        ],
                        "bio": "Chinese astronaut from the CNSA Group-2 selection (2010).",
                        "wiki": "https://en.wikipedia.org/wiki/Cai_Xuzhe",
                        "last_flight": "2024-10-29T20:27:34Z",
                        "first_flight": "2022-06-05T02:44:10Z",
                        "social_media_links": []
                    }
                },
                {
                    "id": 5032,
                    "role": {
                        "id": 34,
                        "role": "EV2",
                        "priority": 1
                    },
                    "astronaut": {
                        "id": 817,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/817/?format=api",
                        "name": "Lingdong Song",
                        "status": {
                            "id": 1,
                            "name": "Active"
                        },
                        "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"
                            }
                        },
                        "image": null,
                        "response_mode": "list",
                        "type": {
                            "id": 2,
                            "name": "Government"
                        },
                        "in_space": false,
                        "time_in_space": "P182DT8H40M39S",
                        "eva_time": "PT22H42M",
                        "age": 35,
                        "date_of_birth": "1990-08-01",
                        "date_of_death": null,
                        "nationality": [
                            {
                                "id": 6,
                                "name": "China",
                                "alpha_2_code": "CN",
                                "alpha_3_code": "CHN",
                                "nationality_name": "Chinese",
                                "nationality_name_composed": "Sino"
                            }
                        ],
                        "bio": "Song Lingdong is a Chinese pilot and astronaut selected as part of the Shenzhou program. He enlisted in the People's Liberation Army (PLA) Air Force in August 2008, and joined the Chinese Communist Party (CCP) in March 2013. He was a Sukhoi Su-35K fighter pilot prior to joining the astronaut corps.",
                        "wiki": null,
                        "last_flight": "2024-10-29T20:27:34Z",
                        "first_flight": "2024-10-29T20:27:34Z",
                        "social_media_links": []
                    }
                }
            ]
        },
        {
            "response_mode": "list",
            "id": 485,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/485/?format=api",
            "name": "Shenzhou 19 EVA 3",
            "start": "2025-03-21T05:50:00Z",
            "end": "2025-03-21T12:50:00Z",
            "duration": "PT7H",
            "location": "Tiangong Space Station",
            "crew": [
                {
                    "id": 5075,
                    "role": {
                        "id": 33,
                        "role": "EV1",
                        "priority": 0
                    },
                    "astronaut": {
                        "id": 731,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/731/?format=api",
                        "name": "Cai Xuzhe",
                        "status": {
                            "id": 1,
                            "name": "Active"
                        },
                        "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"
                            }
                        },
                        "image": {
                            "id": 848,
                            "name": "[AUTO] Cai Xuzhe - image",
                            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cai_xuzhe_image_20220604085007.png",
                            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190933.png",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "response_mode": "list",
                        "type": {
                            "id": 2,
                            "name": "Government"
                        },
                        "in_space": false,
                        "time_in_space": "P364DT18H6M29S",
                        "eva_time": "P1DT10H9M",
                        "age": 49,
                        "date_of_birth": "1976-05-01",
                        "date_of_death": null,
                        "nationality": [
                            {
                                "id": 6,
                                "name": "China",
                                "alpha_2_code": "CN",
                                "alpha_3_code": "CHN",
                                "nationality_name": "Chinese",
                                "nationality_name_composed": "Sino"
                            }
                        ],
                        "bio": "Chinese astronaut from the CNSA Group-2 selection (2010).",
                        "wiki": "https://en.wikipedia.org/wiki/Cai_Xuzhe",
                        "last_flight": "2024-10-29T20:27:34Z",
                        "first_flight": "2022-06-05T02:44:10Z",
                        "social_media_links": []
                    }
                },
                {
                    "id": 5076,
                    "role": {
                        "id": 34,
                        "role": "EV2",
                        "priority": 1
                    },
                    "astronaut": {
                        "id": 817,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/817/?format=api",
                        "name": "Lingdong Song",
                        "status": {
                            "id": 1,
                            "name": "Active"
                        },
                        "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"
                            }
                        },
                        "image": null,
                        "response_mode": "list",
                        "type": {
                            "id": 2,
                            "name": "Government"
                        },
                        "in_space": false,
                        "time_in_space": "P182DT8H40M39S",
                        "eva_time": "PT22H42M",
                        "age": 35,
                        "date_of_birth": "1990-08-01",
                        "date_of_death": null,
                        "nationality": [
                            {
                                "id": 6,
                                "name": "China",
                                "alpha_2_code": "CN",
                                "alpha_3_code": "CHN",
                                "nationality_name": "Chinese",
                                "nationality_name_composed": "Sino"
                            }
                        ],
                        "bio": "Song Lingdong is a Chinese pilot and astronaut selected as part of the Shenzhou program. He enlisted in the People's Liberation Army (PLA) Air Force in August 2008, and joined the Chinese Communist Party (CCP) in March 2013. He was a Sukhoi Su-35K fighter pilot prior to joining the astronaut corps.",
                        "wiki": null,
                        "last_flight": "2024-10-29T20:27:34Z",
                        "first_flight": "2024-10-29T20:27:34Z",
                        "social_media_links": []
                    }
                }
            ]
        }
    ]
}