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=822&ordering=-flights_count
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 824,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=812&ordering=-flights_count",
    "results": [
        {
            "id": 401,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/401/?format=api",
            "name": "Stephen Thorne",
            "status": {
                "id": 6,
                "name": "Died While In Active Service"
            },
            "agency": {
                "response_mode": "list",
                "id": 44,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/44/?format=api",
                "name": "National Aeronautics and Space Administration",
                "abbrev": "NASA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 419,
                "name": "[AUTO] Stephen Thorne - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/stephen2520thorne_image_20181202135603.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185814.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": "P0D",
            "eva_time": "P0D",
            "age": 33,
            "date_of_birth": "1953-02-11",
            "date_of_death": "1986-05-24",
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Stephen Douglas Thorne was an American naval officer and aviator, test pilot and a NASA astronaut candidate.\r\n\r\nHe was born on February 11, 1953, in Frankfurt, West Germany, and graduated from the U.S. Naval Academy in 1975. He was a Navy fighter pilot from 1976 until he became a test pilot in 1981.\r\n\r\nHe was accepted for NASA astronaut training in June 1985, but died in an airplane accident where he was a passenger on May 24, 1986.",
            "wiki": "https://en.wikipedia.org/wiki/Stephen_Thorne_(astronaut)",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        },
        {
            "id": 87,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/87/?format=api",
            "name": "Chen Quan",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "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": 377,
                "name": "[AUTO] Chen Quan - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/chen2520quan_image_20181128224630.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185710.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": "P0D",
            "eva_time": "P0D",
            "age": 61,
            "date_of_birth": "1963-12-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 Quan (simplified Chinese: 陈全; traditional Chinese: 陳全; pinyin: Chén Quán) is a Chinese pilot selected as part of the Shenzhou program.\r\n\r\nChen was selected to be an astronaut in 1998 and served as commander of the backup crew for Shenzhou 7 which flew in September 2008.",
            "wiki": "https://en.wikipedia.org/wiki/Chen_Quan",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        }
    ]
}