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

{
    "id": 421,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/421/?format=api",
    "name": "James S. Voss",
    "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": 588,
        "name": "[AUTO] James S. Voss - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/james2520s.2520voss_image_20181202141642.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190239.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": "P203DT5H27M41S",
    "eva_time": "PT22H45M",
    "age": 76,
    "date_of_birth": "1949-03-03",
    "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": "James Shelton Voss is a retired United States Army Colonel and NASA astronaut. During his time with NASA, Voss flew in space five times on board the Space Shuttle and International Space Station. He also served as deputy of Flight Operations for the Space Station Program Mission Integration and Operations Office. While participating in ISS Expedition 2, he and Susan Helms conducted an 8-hour and 56 minute spacewalk, the longest to date.",
    "wiki": "https://en.wikipedia.org/wiki/James_S._Voss",
    "last_flight": "2001-03-08T11:42:09Z",
    "first_flight": "1991-11-24T23:44:00Z",
    "social_media_links": [],
    "flights_count": 5,
    "landings_count": 5,
    "spacewalks_count": 4,
    "flights": [],
    "landings": [],
    "spacewalks": [
        {
            "response_mode": "list",
            "id": 297,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/297/?format=api",
            "name": "Expedition 2 EVA",
            "start": "2001-06-08T14:21:00Z",
            "end": "2001-06-08T14:40:00Z",
            "duration": "PT19M",
            "location": "International Space Station",
            "crew": [
                {
                    "id": 4362,
                    "role": {
                        "id": 33,
                        "role": "EV1",
                        "priority": 0
                    },
                    "astronaut": {
                        "id": 274,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/274/?format=api",
                        "name": "Yury Usachov",
                        "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": 648,
                            "name": "[AUTO] Yury Usachov - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/yury2520usachov_image_20181201223522.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190415.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": "P552DT22H23M37S",
                        "eva_time": "P1DT6H49M",
                        "age": 67,
                        "date_of_birth": "1957-10-09",
                        "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": "Yury Vladimirovich Usachov (Russian: Юрий Владимирович Усачёв; born October 9, 1957 in Donetsk, Rostov Oblast, Russia) is a former cosmonaut who resides in Star City, Moscow. Usachov is a veteran of four spaceflights, including two long duration missions on board the Mir Space Station and another on board the International Space Station.",
                        "wiki": "https://en.wikipedia.org/wiki/Yury_Usachov",
                        "last_flight": "2001-03-08T11:42:09Z",
                        "first_flight": "1994-01-08T10:05:34Z",
                        "social_media_links": []
                    }
                },
                {
                    "id": 4363,
                    "role": {
                        "id": 34,
                        "role": "EV2",
                        "priority": 1
                    },
                    "astronaut": {
                        "id": 421,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/421/?format=api",
                        "name": "James S. Voss",
                        "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": 588,
                            "name": "[AUTO] James S. Voss - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/james2520s.2520voss_image_20181202141642.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190239.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": "P203DT5H27M41S",
                        "eva_time": "PT22H45M",
                        "age": 76,
                        "date_of_birth": "1949-03-03",
                        "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": "James Shelton Voss is a retired United States Army Colonel and NASA astronaut. During his time with NASA, Voss flew in space five times on board the Space Shuttle and International Space Station. He also served as deputy of Flight Operations for the Space Station Program Mission Integration and Operations Office. While participating in ISS Expedition 2, he and Susan Helms conducted an 8-hour and 56 minute spacewalk, the longest to date.",
                        "wiki": "https://en.wikipedia.org/wiki/James_S._Voss",
                        "last_flight": "2001-03-08T11:42:09Z",
                        "first_flight": "1991-11-24T23:44:00Z",
                        "social_media_links": []
                    }
                }
            ]
        }
    ]
}