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

{
    "count": 813,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=800&ordering=name",
    "results": [
        {
            "id": 297,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/297/?format=api",
            "name": "Zhang Xiaoguang",
            "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": 807,
                "name": "[AUTO] Zhang Xiaoguang - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/zhang2520xiaoguang_image_20181201232412.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190829.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": false,
            "time_in_space": "P14DT14H28M58S",
            "eva_time": "P0D",
            "age": 59,
            "date_of_birth": "1966-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": "Zhang Xiaoguang is a Chinese pilot selected as part of the Shenzhou program.\r\n\r\nHe was born in May 1966 in Jinzhou, to a family of Manchu ethnicity and was a squadron commander in the People’s Liberation Army Air Force when he was selected to be an astronaut in 1998. He had accumulated 1000 flight-hours as of 2004. He was selected as part of the backup crew for the Shenzhou 9 mission. In 2013, he was selected to fly Shenzhou 10, the third spaceflight to the first Chinese space station Tiangong 1.",
            "wiki": "https://en.wikipedia.org/wiki/Zhang_Xiaoguang",
            "last_flight": "2013-06-11T09:38:02Z",
            "first_flight": "2013-06-11T09:38:02Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 840,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/840/?format=api",
            "name": "Zhongrui Chen",
            "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": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": true,
            "time_in_space": "P37DT16H44M6S",
            "eva_time": "PT7H59M",
            "age": 40,
            "date_of_birth": "1984-10-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": "Chen Zhongrui 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 September 2003, and joined the Chinese Communist Party (CCP) in June 2005. He was a PLAAF flight instructor prior to joining the astronaut corps.",
            "wiki": null,
            "last_flight": "2025-04-24T09:17:31Z",
            "first_flight": "2025-04-24T09:17:31Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 0,
            "spacewalks_count": 1
        },
        {
            "id": 743,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/743/?format=api",
            "name": "Zohar",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "agency": {
                "response_mode": "list",
                "id": 29,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/29/?format=api",
                "name": "German Aerospace Center",
                "abbrev": "DLR",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 287,
                "name": "Helga and Zohar",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/helga_image_20220818113731.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185437.jpeg",
                "credit": "DLR",
                "license": {
                    "id": 8,
                    "name": "CC BY-NC-ND 3.0",
                    "priority": 3,
                    "link": "https://creativecommons.org/licenses/by-nc-nd/3.0/de/deed.de"
                },
                "single_use": false,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 6,
                "name": "Non-Human"
            },
            "in_space": false,
            "time_in_space": "P25DT10H52M46S",
            "eva_time": "P0D",
            "age": null,
            "date_of_birth": null,
            "date_of_death": null,
            "nationality": [
                {
                    "id": 17,
                    "name": "Unknown",
                    "alpha_2_code": "??",
                    "alpha_3_code": "???",
                    "nationality_name": "Earthling",
                    "nationality_name_composed": "Earthling"
                }
            ],
            "bio": "Mannequin used as part of the DLR MARE radiations measurement experiment.",
            "wiki": null,
            "last_flight": "2022-11-16T06:47:44Z",
            "first_flight": "2022-11-16T06:47:44Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        }
    ]
}