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=820&ordering=-spacewalks_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=810&ordering=-spacewalks_count",
    "results": [
        {
            "id": 64,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/64/?format=api",
            "name": "Toktar Aubakirov",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "agency": {
                "response_mode": "list",
                "id": 63,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "abbrev": "RFSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 627,
                "name": "[AUTO] Toktar Aubakirov - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/toktar2520aubakirov_image_20181128220647.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190340.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": "P7DT22H12M22S",
            "eva_time": "P0D",
            "age": 79,
            "date_of_birth": "1946-07-27",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 44,
                    "name": "Kazakhstan",
                    "alpha_2_code": "KZ",
                    "alpha_3_code": "KAZ",
                    "nationality_name": "Kazakh",
                    "nationality_name_composed": "Kazakhstani"
                }
            ],
            "bio": "Toktar Ongarbayuly Aubakirov (Kazakh: Тоқтар Оңғарбайұлы Әубәкіров, Russian: Токтар Онгарбаевич Аубакиров, born on 27 July 1946) is a retired Kazakh Air Force officer and a former cosmonaut.\r\n\r\nIn 1991, in accordance with an agreement between the governments of the USSR and the Kazakh SSR, started training at the Gagarin Cosmonaut Training Center. On 2 October 1991 he launched with Russian cosmonaut Alexander Volkov as flight commander, and the Austrian research cosmonaut Franz Viehböck in Soyuz TM-13 from the Baikonur Cosmodrome spaceport, and spent over eight days in space.",
            "wiki": "https://en.wikipedia.org/wiki/Toktar_Aubakirov",
            "last_flight": "1991-10-02T05:59:38Z",
            "first_flight": "1991-10-02T05:59:38Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 368,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/368/?format=api",
            "name": "Bryan D. O'Connor",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "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": 629,
                "name": "[AUTO] Bryan D. O'Connor - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/bryan2520d.2520o2527connor_image_20181202120241.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190344.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": "P15DT23H18M9S",
            "eva_time": "P0D",
            "age": 79,
            "date_of_birth": "1946-09-06",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Bryan Daniel O'Connor is a retired United States Marine Corps Colonel and former NASA astronaut.",
            "wiki": "https://en.wikipedia.org/wiki/Bryan_D._O%27Connor",
            "last_flight": "1991-06-05T13:24:51Z",
            "first_flight": "1985-11-27T00:29:00Z",
            "social_media_links": [],
            "flights_count": 2,
            "landings_count": 2,
            "spacewalks_count": 0
        },
        {
            "id": 131,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/131/?format=api",
            "name": "Steven Hawley",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "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": 630,
                "name": "[AUTO] Steven Hawley - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/steven2520hawley_image_20181129204324.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190345.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": "P32DT2H39M2S",
            "eva_time": "P0D",
            "age": 73,
            "date_of_birth": "1951-12-12",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Steven Alan Hawley is a former NASA astronaut who flew on five U.S. Space Shuttle flights. He is professor of physics and astronomy and director of engineering physics at the University of Kansas. \r\n\r\nFollowing an aborted attempt to launch STS-41-D where two main engines were stopped shortly after they started because the third failed to start, Hawley is reported to have broken the tense atmosphere in the shuttle cabin, saying, \"I thought we'd be a lot higher at MECO!\"",
            "wiki": "https://en.wikipedia.org/wiki/Steven_Hawley",
            "last_flight": "1999-07-23T04:31:00Z",
            "first_flight": "1984-08-30T12:41:50Z",
            "social_media_links": [],
            "flights_count": 5,
            "landings_count": 5,
            "spacewalks_count": 0
        },
        {
            "id": 450,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/450/?format=api",
            "name": "Wendy B. Lawrence",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "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": 634,
                "name": "[AUTO] Wendy B. Lawrence - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/wendy2520b.2520lawrence_image_20181202144930.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190351.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": "P51DT3H55M4S",
            "eva_time": "P0D",
            "age": 66,
            "date_of_birth": "1959-07-02",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Wendy Barrien Lawrence is a retired United States Navy Captain, former helicopter pilot, an engineer, and a former NASA astronaut. She was the first female graduate of the United States Naval Academy to fly into space and she has also visited the Russian Space Station Mir. She was a mission specialist on STS-114, the first Space Shuttle flight after the Space Shuttle Columbia disaster.",
            "wiki": "https://en.wikipedia.org/wiki/Wendy_B._Lawrence",
            "last_flight": "2005-07-26T14:39:00Z",
            "first_flight": "1995-03-02T06:38:13Z",
            "social_media_links": [
                {
                    "id": 169,
                    "social_media": {
                        "id": 1,
                        "name": "X",
                        "url": "https://x.com",
                        "logo": {
                            "id": 2320,
                            "name": "X logo",
                            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/x_logo_image_20250211191027.jpg",
                            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/x_logo_image_thumbnail_20250211191027.jpeg",
                            "credit": "X",
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        }
                    },
                    "url": "https://twitter.com/AstroWendyL"
                }
            ],
            "flights_count": 4,
            "landings_count": 4,
            "spacewalks_count": 0
        }
    ]
}