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

{
    "id": 233,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/233/?format=api",
    "name": "Roman Romanenko",
    "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": 729,
        "name": "[AUTO] Roman Romanenko - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/roman2520romanenko_image_20181201213713.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190629.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": "P333DT11H32S",
    "eva_time": "PT6H38M",
    "age": 53,
    "date_of_birth": "1971-08-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": "Roman Yurievich Romanenko (Major, Russian Air Force; Russian: Роман Юрьевич Романенко; born August 9, 1971) is a retired cosmonaut at the Yuri Gagarin Cosmonaut Training Center.\r\nRomanenko was selected as a cosmonaut candidate at the Gagarin Cosmonaut Training Center Cosmonaut Office in December 1997. From January 1998 to November 1999 he undertook his basic training course. In November 1999 he was qualified as a Test Cosmonaut.\r\n\r\nHe served as the backup to Oleg Kotov as the Commander of Soyuz TMA-10 and Fyodor Yurchikhin as Commander of Expedition 15.",
    "wiki": "https://en.wikipedia.org/wiki/Roman_Romanenko",
    "last_flight": "2012-12-19T12:12:35Z",
    "first_flight": "2009-05-27T10:34:53Z",
    "social_media_links": [],
    "flights_count": 2,
    "landings_count": 2,
    "spacewalks_count": 1,
    "flights": [],
    "landings": [],
    "spacewalks": [
        {
            "response_mode": "list",
            "id": 354,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/354/?format=api",
            "name": "Expedition 35 EVA 1",
            "start": "2013-04-19T14:03:00Z",
            "end": "2013-04-19T20:41:00Z",
            "duration": "PT6H38M",
            "location": "International Space Station",
            "crew": [
                {
                    "id": 4476,
                    "role": {
                        "id": 33,
                        "role": "EV1",
                        "priority": 0
                    },
                    "astronaut": {
                        "id": 278,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/278/?format=api",
                        "name": "Pavel Vinogradov",
                        "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": 373,
                            "name": "[AUTO] Pavel Vinogradov - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pavel2520vinogradov_image_20181201224203.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185703.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": "P546DT22H31M26S",
                        "eva_time": "P1DT14H25M",
                        "age": 71,
                        "date_of_birth": "1953-08-31",
                        "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": "Pavel Vladimirovich Vinogradov (Russian: Павел Владимирович Виноградов; born August 31, 1953 in Magadan, USSR) is a cosmonaut and former commander of the International Space Station. As of May 2013, he has flown into space three times, aboard Mir and the International Space Station, and is one of the top 10 astronauts in terms of total time in space. Vinogradov has also conducted seven spacewalks in his cosmonaut career, and holds the record for the oldest person to perform a spacewalk.",
                        "wiki": "https://en.wikipedia.org/wiki/Pavel_Vinogradov",
                        "last_flight": "2013-03-28T20:43:20Z",
                        "first_flight": "1997-08-05T15:35:54Z",
                        "social_media_links": []
                    }
                },
                {
                    "id": 4477,
                    "role": {
                        "id": 34,
                        "role": "EV2",
                        "priority": 1
                    },
                    "astronaut": {
                        "id": 233,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/233/?format=api",
                        "name": "Roman Romanenko",
                        "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": 729,
                            "name": "[AUTO] Roman Romanenko - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/roman2520romanenko_image_20181201213713.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190629.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": "P333DT11H32S",
                        "eva_time": "PT6H38M",
                        "age": 53,
                        "date_of_birth": "1971-08-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": "Roman Yurievich Romanenko (Major, Russian Air Force; Russian: Роман Юрьевич Романенко; born August 9, 1971) is a retired cosmonaut at the Yuri Gagarin Cosmonaut Training Center.\r\nRomanenko was selected as a cosmonaut candidate at the Gagarin Cosmonaut Training Center Cosmonaut Office in December 1997. From January 1998 to November 1999 he undertook his basic training course. In November 1999 he was qualified as a Test Cosmonaut.\r\n\r\nHe served as the backup to Oleg Kotov as the Commander of Soyuz TMA-10 and Fyodor Yurchikhin as Commander of Expedition 15.",
                        "wiki": "https://en.wikipedia.org/wiki/Roman_Romanenko",
                        "last_flight": "2012-12-19T12:12:35Z",
                        "first_flight": "2009-05-27T10:34:53Z",
                        "social_media_links": []
                    }
                }
            ]
        }
    ]
}