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=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=812&ordering=spacewalks_count",
    "results": [
        {
            "id": 513,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/513/?format=api",
            "name": "Peggy Whitson",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "agency": {
                "response_mode": "list",
                "id": 1022,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1022/?format=api",
                "name": "Axiom Space",
                "abbrev": "AXS",
                "type": {
                    "id": 5,
                    "name": "Private"
                }
            },
            "image": {
                "id": 821,
                "name": "[AUTO] Peggy Whitson - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/peggy_whitson_image_20210210144848.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190851.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": "P695DT6H50M18S",
            "eva_time": "P2DT12H25M",
            "age": 65,
            "date_of_birth": "1960-02-09",
            "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": "Peggy Annette Whitson is an American biochemistry researcher, retired NASA astronaut, and former NASA Chief Astronaut. Her first space mission was in 2002, with an extended stay aboard the International Space Station as a member of Expedition 5. Her second mission launched October 10, 2007, as the first female commander of the ISS with Expedition 16. She was on her third long-duration space flight and was the commander of the International Space Station for Expedition 51, before handing over command to Fyodor Yurchikhin on June 1, 2017.",
            "wiki": "https://en.wikipedia.org/wiki/Peggy_Whitson",
            "last_flight": "2025-06-25T06:31:52Z",
            "first_flight": "2002-06-05T21:22:49Z",
            "social_media_links": [
                {
                    "id": 32,
                    "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/AstroPeggy"
                },
                {
                    "id": 33,
                    "social_media": {
                        "id": 2,
                        "name": "Instagram",
                        "url": "https://instagram.com",
                        "logo": {
                            "id": 2322,
                            "name": "Instagram logo",
                            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/instagram_logo_image_20250211191139.png",
                            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/instagram_logo_image_thumbnail_20250211191139.png",
                            "credit": "Instagram",
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        }
                    },
                    "url": "https://www.instagram.com/astro_peggy/"
                }
            ],
            "flights_count": 5,
            "landings_count": 5,
            "spacewalks_count": 10
        },
        {
            "id": 257,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/257/?format=api",
            "name": "Anatoly Solovyev",
            "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": 460,
                "name": "[AUTO] Anatoly Solovyev - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/anatoly2520solovyev_image_20181201221333.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185917.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": "P651DT1M21S",
            "eva_time": "P3DT6H48M",
            "age": 77,
            "date_of_birth": "1948-01-16",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "bio": "Anatoly Yakovlevich Solovyev (Russian: Анатолий Яковлевич Соловьёв; born January 16, 1948 – alternate spelling \"Solovyov\") is a retired Russian and Soviet cosmonaut and pilot. Solovyev holds the world record on the number of spacewalks performed (16), and accumulated time spent spacewalking (over 82 hours).",
            "wiki": "https://en.wikipedia.org/wiki/Anatoly_Solovyev",
            "last_flight": "1997-08-05T15:35:54Z",
            "first_flight": "1988-06-07T14:03:13Z",
            "social_media_links": [],
            "flights_count": 5,
            "landings_count": 5,
            "spacewalks_count": 16
        }
    ]
}