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=-time_in_space
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=-time_in_space",
    "results": [
        {
            "id": 320,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/320/?format=api",
            "name": "Philip K. Chapman",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "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": 598,
                "name": "[AUTO] Philip K. Chapman - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/philip2520k.2520chapman_image_20181202092722.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190255.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": 86,
            "date_of_birth": "1935-03-05",
            "date_of_death": "2021-04-05",
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Philip Kenyon Chapman was the first Australian-born American astronaut, serving for about five years in NASA Astronaut Group 6 (1967).",
            "wiki": "https://en.wikipedia.org/wiki/Philip_K._Chapman",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        },
        {
            "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-prod.nyc3.digitaloceanspaces.com/media/images/stephen2520thorne_image_20181202135603.jpg",
                "thumbnail_url": "https://thespacedevs-prod.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": 671,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/671/?format=api",
            "name": "Michael Alsbury",
            "status": {
                "id": 4,
                "name": "Lost In Flight"
            },
            "agency": {
                "response_mode": "list",
                "id": 1024,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1024/?format=api",
                "name": "Virgin Galactic",
                "abbrev": "VG",
                "type": {
                    "id": 5,
                    "name": "Private"
                }
            },
            "image": {
                "id": 608,
                "name": "[AUTO] Michael Alsbury - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/michael_alsbury_image_20210522144654.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190310.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 3,
                "name": "Private"
            },
            "in_space": false,
            "time_in_space": "P0D",
            "eva_time": "P0D",
            "age": 39,
            "date_of_birth": "1975-03-19",
            "date_of_death": "2014-10-31",
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Michael Tyner Alsbury was an American test pilot for Scaled Composites. On October 31, 2014, Alsbury was test flying the Virgin Galactic SpaceShipTwo, VSS Enterprise with Peter Siebold. The craft broke up in-flight, resulting in a total loss of VSS Enterprise, which crashed in the California Mojave Desert.",
            "wiki": "https://en.wikipedia.org/wiki/Michael_Alsbury",
            "last_flight": "2014-10-31T12:00:00Z",
            "first_flight": "2010-10-10T12:00:00Z",
            "social_media_links": [],
            "flights_count": 9,
            "landings_count": 9,
            "spacewalks_count": 0
        }
    ]
}