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

{
    "id": 417,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/417/?format=api",
    "name": "Michael Foale",
    "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": 704,
        "name": "[AUTO] Michael Foale - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/michael2520foale_image_20181202141301.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190542.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": "P373DT18H16M26S",
    "eva_time": "PT22H34M",
    "age": 68,
    "date_of_birth": "1957-01-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": "Colin Michael Foale CBE is a British-American astrophysicist and former NASA astronaut. He is a veteran of six space missions, and is the only NASA astronaut to have flown extended missions aboard both Mir and the International Space Station. He was the first Briton to perform a space walk, and until 17 April 2008, he held the record for most time spent in space by a US citizen: 374 days, 11 hours, 19 minutes. He still holds the cumulative-time-in-space record for a UK citizen.",
    "wiki": "https://en.wikipedia.org/wiki/Michael_Foale",
    "last_flight": "2003-10-18T05:38:03Z",
    "first_flight": "1992-03-24T13:13:39Z",
    "social_media_links": [],
    "flights_count": 6,
    "landings_count": 6,
    "spacewalks_count": 4,
    "flights": [],
    "landings": [],
    "spacewalks": [
        {
            "response_mode": "list",
            "id": 118,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/118/?format=api",
            "name": "PE-24 EVA 2",
            "start": "1997-09-06T01:07:00Z",
            "end": "1997-09-06T07:07:00Z",
            "duration": "PT6H",
            "location": "Mir",
            "crew": [
                {
                    "id": 4003,
                    "role": {
                        "id": 33,
                        "role": "EV1",
                        "priority": 0
                    },
                    "astronaut": {
                        "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-prod.nyc3.digitaloceanspaces.com/media/images/anatoly2520solovyev_image_20181201221333.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.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": "list",
                        "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": []
                    }
                },
                {
                    "id": 4004,
                    "role": {
                        "id": 34,
                        "role": "EV2",
                        "priority": 1
                    },
                    "astronaut": {
                        "id": 417,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/417/?format=api",
                        "name": "Michael Foale",
                        "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": 704,
                            "name": "[AUTO] Michael Foale - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/michael2520foale_image_20181202141301.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190542.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": "P373DT18H16M26S",
                        "eva_time": "PT22H34M",
                        "age": 68,
                        "date_of_birth": "1957-01-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": "Colin Michael Foale CBE is a British-American astrophysicist and former NASA astronaut. He is a veteran of six space missions, and is the only NASA astronaut to have flown extended missions aboard both Mir and the International Space Station. He was the first Briton to perform a space walk, and until 17 April 2008, he held the record for most time spent in space by a US citizen: 374 days, 11 hours, 19 minutes. He still holds the cumulative-time-in-space record for a UK citizen.",
                        "wiki": "https://en.wikipedia.org/wiki/Michael_Foale",
                        "last_flight": "2003-10-18T05:38:03Z",
                        "first_flight": "1992-03-24T13:13:39Z",
                        "social_media_links": []
                    }
                }
            ]
        },
        {
            "response_mode": "list",
            "id": 309,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/309/?format=api",
            "name": "Expedition 8 EVA",
            "start": "2004-02-26T21:17:00Z",
            "end": "2004-02-27T01:12:00Z",
            "duration": "PT3H55M",
            "location": "International Space Station",
            "crew": [
                {
                    "id": 4386,
                    "role": {
                        "id": 33,
                        "role": "EV1",
                        "priority": 0
                    },
                    "astronaut": {
                        "id": 417,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/417/?format=api",
                        "name": "Michael Foale",
                        "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": 704,
                            "name": "[AUTO] Michael Foale - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/michael2520foale_image_20181202141301.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190542.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": "P373DT18H16M26S",
                        "eva_time": "PT22H34M",
                        "age": 68,
                        "date_of_birth": "1957-01-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": "Colin Michael Foale CBE is a British-American astrophysicist and former NASA astronaut. He is a veteran of six space missions, and is the only NASA astronaut to have flown extended missions aboard both Mir and the International Space Station. He was the first Briton to perform a space walk, and until 17 April 2008, he held the record for most time spent in space by a US citizen: 374 days, 11 hours, 19 minutes. He still holds the cumulative-time-in-space record for a UK citizen.",
                        "wiki": "https://en.wikipedia.org/wiki/Michael_Foale",
                        "last_flight": "2003-10-18T05:38:03Z",
                        "first_flight": "1992-03-24T13:13:39Z",
                        "social_media_links": []
                    }
                },
                {
                    "id": 4387,
                    "role": {
                        "id": 34,
                        "role": "EV2",
                        "priority": 1
                    },
                    "astronaut": {
                        "id": 160,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/160/?format=api",
                        "name": "Aleksandr Kaleri",
                        "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": 718,
                            "name": "[AUTO] Aleksandr Kaleri - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/aleksandr2520kaleri_image_20181129232134.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190613.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": "P769DT6H35M",
                        "eva_time": "PT23H23M",
                        "age": 68,
                        "date_of_birth": "1956-05-13",
                        "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": "Aleksandr Yuriyevich \"Sasha\" Kaleri (Russian: Александр Юрьевич Калери; born Jūrmala, Latvian SSR, USSR, 13 May 1956) is a Russian cosmonaut and veteran of extended stays on the Mir Space Station and the International Space Station (ISS). Kaleri has most recently been in space aboard the ISS serving as a flight engineer for the long duration Expedition 25/26 missions. He has spent the fourth-longest time in space of any person, the longest time in space of any currently active cosmonaut, and the longest time in space of any person not born in what is now Russia.",
                        "wiki": "https://en.wikipedia.org/wiki/Aleksandr_Kaleri",
                        "last_flight": "2010-10-07T23:10:55Z",
                        "first_flight": "1992-03-17T10:54:30Z",
                        "social_media_links": []
                    }
                }
            ]
        }
    ]
}