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 - ll.thespacedevs.com/docs

GET /2.3.0/astronauts/?format=api&offset=810&ordering=-date_of_birth
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 813,
    "next": null,
    "previous": "https://ll.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=800&ordering=-date_of_birth",
    "results": [
        {
            "id": 25,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/25/?format=api",
            "name": "John Glenn",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "agency": {
                "response_mode": "list",
                "id": 44,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/44/?format=api",
                "name": "National Aeronautics and Space Administration",
                "abbrev": "NASA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 516,
                "name": "[AUTO] John Glenn - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/john2520glenn_image_20181128141704.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190045.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": "P9DT2H39M47S",
            "eva_time": "P0D",
            "age": 95,
            "date_of_birth": "1921-07-18",
            "date_of_death": "2016-12-08",
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Colonel John Herschel Glenn Jr. was a United States Marine Corps aviator, engineer, astronaut, businessman, and politician. He was the first American to orbit the Earth, circling it three times in 1962. Following his retirement from NASA, he served from 1974 to 1999 as a Democratic United States Senator from Ohio.",
            "wiki": "https://en.wikipedia.org/wiki/John_Glenn",
            "last_flight": "1998-10-29T19:19:34Z",
            "first_flight": "1962-02-20T14:47:39Z",
            "social_media_links": [],
            "flights_count": 2,
            "landings_count": 2,
            "spacewalks_count": 0
        },
        {
            "id": 78,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/78/?format=api",
            "name": "Georgy Beregovoy",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "agency": {
                "response_mode": "list",
                "id": 63,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "abbrev": "RFSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 677,
                "name": "[AUTO] Georgy Beregovoy - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/georgy2520beregovoy_image_20181128223141.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190459.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": "P3DT22H50M45S",
            "eva_time": "P0D",
            "age": 74,
            "date_of_birth": "1921-04-15",
            "date_of_death": "1995-06-30",
            "nationality": [
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "bio": "Georgy Timofeyevich Beregovoy (Russian: Гео́ргий Тимофе́евич Берегово́й, Ukrainian: Гео́ргій Тимофі́йович Берегови́й; April 15, 1921 – June 30, 1995) was a Soviet cosmonaut who commanded the space mission Soyuz 3 in 1968. At the time of his flight, Beregovoy was 47 years of age: he was the earliest-born human to go to orbit, being born three months and three days earlier than the second earliest-born man in orbit – John Glenn, but later than X-15 pilot Joe Walker who made 2 (or 3, according to USAF definition) suborbital space flights.",
            "wiki": "https://en.wikipedia.org/wiki/Georgy_Beregovoy",
            "last_flight": "1968-10-26T08:34:18Z",
            "first_flight": "1968-10-26T08:34:18Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 648,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/648/?format=api",
            "name": "Joseph A. Walker",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "agency": {
                "response_mode": "list",
                "id": 44,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/44/?format=api",
                "name": "National Aeronautics and Space Administration",
                "abbrev": "NASA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 261,
                "name": "[AUTO] Joseph A. Walker - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/joseph_a._walke_image_20200711033534.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185351.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": "PT2H32M32S",
            "eva_time": "P0D",
            "age": 45,
            "date_of_birth": "1921-02-20",
            "date_of_death": "1966-06-08",
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Joseph Albert Walker was an American World War II pilot, experimental physicist, NASA test pilot, and astronaut. He was one of twelve pilots who flew the North American X-15, an experimental spaceplane jointly operated by the Air Force and NASA.",
            "wiki": "https://en.wikipedia.org/wiki/Joseph_A._Walker",
            "last_flight": "1963-08-22T18:05:57Z",
            "first_flight": "1963-01-17T16:59:00Z",
            "social_media_links": [],
            "flights_count": 3,
            "landings_count": 3,
            "spacewalks_count": 0
        }
    ]
}