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/523/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "id": 523,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/523/?format=api",
    "name": "Clayton Anderson",
    "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": 231,
        "name": "[AUTO] Clayton Anderson - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/clayton2520anderson_image_20181203163525.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185300.jpeg",
        "credit": null,
        "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
        },
        "single_use": true,
        "variants": []
    },
    "response_mode": "detailed",
    "type": {
        "id": 2,
        "name": "Government"
    },
    "in_space": false,
    "time_in_space": "P166DT21H9M34S",
    "eva_time": "P1DT14H9M",
    "age": 66,
    "date_of_birth": "1959-02-23",
    "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": "Clayton Conrad Anderson is a retired NASA astronaut. Launched on STS-117, he replaced Sunita Williams on June 10, 2007 as a member of the ISS Expedition 15 crew.",
    "wiki": "https://en.wikipedia.org/wiki/Clayton_Anderson",
    "last_flight": "2010-04-05T10:21:22Z",
    "first_flight": "2007-06-08T23:38:04Z",
    "social_media_links": [
        {
            "id": 168,
            "social_media": {
                "id": 1,
                "name": "X",
                "url": "https://x.com",
                "logo": {
                    "id": 2320,
                    "name": "X logo",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/x_logo_image_20250211191027.jpg",
                    "thumbnail_url": "https://thespacedevs-prod.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/Astro_Clay"
        }
    ],
    "flights_count": 2,
    "landings_count": 2,
    "spacewalks_count": 6,
    "flights": [],
    "landings": [],
    "spacewalks": [
        {
            "response_mode": "list",
            "id": 327,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/327/?format=api",
            "name": "Expedition 15 EVA 3",
            "start": "2007-07-23T10:25:00Z",
            "end": "2007-07-23T18:06:00Z",
            "duration": "PT7H41M",
            "location": "International Space Station",
            "crew": [
                {
                    "id": 4422,
                    "role": {
                        "id": 33,
                        "role": "EV1",
                        "priority": 0
                    },
                    "astronaut": {
                        "id": 523,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/523/?format=api",
                        "name": "Clayton Anderson",
                        "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": 231,
                            "name": "[AUTO] Clayton Anderson - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/clayton2520anderson_image_20181203163525.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185300.jpeg",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "response_mode": "list",
                        "type": {
                            "id": 2,
                            "name": "Government"
                        },
                        "in_space": false,
                        "time_in_space": "P166DT21H9M34S",
                        "eva_time": "P1DT14H9M",
                        "age": 66,
                        "date_of_birth": "1959-02-23",
                        "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": "Clayton Conrad Anderson is a retired NASA astronaut. Launched on STS-117, he replaced Sunita Williams on June 10, 2007 as a member of the ISS Expedition 15 crew.",
                        "wiki": "https://en.wikipedia.org/wiki/Clayton_Anderson",
                        "last_flight": "2010-04-05T10:21:22Z",
                        "first_flight": "2007-06-08T23:38:04Z",
                        "social_media_links": [
                            {
                                "id": 168,
                                "social_media": {
                                    "id": 1,
                                    "name": "X",
                                    "url": "https://x.com",
                                    "logo": {
                                        "id": 2320,
                                        "name": "X logo",
                                        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/x_logo_image_20250211191027.jpg",
                                        "thumbnail_url": "https://thespacedevs-prod.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/Astro_Clay"
                            }
                        ]
                    }
                },
                {
                    "id": 4423,
                    "role": {
                        "id": 34,
                        "role": "EV2",
                        "priority": 1
                    },
                    "astronaut": {
                        "id": 294,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/294/?format=api",
                        "name": "Fyodor Yurchikhin",
                        "status": {
                            "id": 1,
                            "name": "Active"
                        },
                        "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": 500,
                            "name": "[AUTO] Fyodor Yurchikhin - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/fyodor2520yurchikhin_image_20181201232049.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190020.jpeg",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "response_mode": "list",
                        "type": {
                            "id": 2,
                            "name": "Government"
                        },
                        "in_space": false,
                        "time_in_space": "P672DT20H39M32S",
                        "eva_time": "P2DT11H27M",
                        "age": 66,
                        "date_of_birth": "1959-01-03",
                        "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": "Fyodor Nikolayevich Yurchikhin (Russian: Фёдор Николаевич Юрчихин, Greek: Θεόδωρος Γιουρτσίχιν του Νικόλαου; born 3 January 1959), is a Russian cosmonaut of Greek descent, engineer and RSC Energia test-pilot who has flown on five spaceflights. His first spaceflight was a 10-day Space Shuttle mission STS-112. His second was a long-duration stay aboard the International Space Station (ISS) as a Flight Engineer for Expedition 15; for this mission he was launched in the Soyuz TMA-10 spacecraft. He has undertaken two further long-duration stays aboard the ISS, as a crew member of Expedition 24 / 25. For this mission he was launched with the spacecraft Soyuz TMA-19, and he landed in November 2010, also with the TMA-19 spacecraft. He served as Soyuz Commander for his fourth mission aboard Soyuz TMA-09M, as Flight Engineer for Expedition 36 and ISS Commander for Expedition 37. In April 2017, Yurchikhin launched on Soyuz MS-04 for the fifth spaceflight of his career, a six-month mission to the ISS as part of Expedition 51 and 52, for which he was the Commander.",
                        "wiki": "https://en.wikipedia.org/wiki/Fyodor_Yurchikhin",
                        "last_flight": "2017-04-20T07:13:45Z",
                        "first_flight": "2002-10-07T19:45:51Z",
                        "social_media_links": []
                    }
                }
            ]
        }
    ]
}