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

{
    "id": 2,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/2/?format=api",
    "name": "Claude Nicollier",
    "status": {
        "id": 2,
        "name": "Retired"
    },
    "agency": {
        "response_mode": "list",
        "id": 27,
        "url": "https://lldev.thespacedevs.com/2.3.0/agencies/27/?format=api",
        "name": "European Space Agency",
        "abbrev": "ESA",
        "type": {
            "id": 2,
            "name": "Multinational"
        }
    },
    "image": {
        "id": 328,
        "name": "[AUTO] Claude Nicollier - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/claude2520nicollier_image_20181127203218.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185551.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": "P42DT12H3M12S",
    "eva_time": "PT8H10M",
    "age": 80,
    "date_of_birth": "1944-09-02",
    "date_of_death": null,
    "nationality": [
        {
            "id": 8,
            "name": "Switzerland",
            "alpha_2_code": "CH",
            "alpha_3_code": "CHE",
            "nationality_name": "Swiss",
            "nationality_name_composed": "Swiss"
        }
    ],
    "bio": "Claude Nicollier is the first astronaut from Switzerland. He has flown on four Space Shuttle missions. His first spaceflight (STS-46) was in 1992, and his final spaceflight (STS-103) was in 1999. He took part in two servicing missions to the Hubble Space Telescope (called STS-61 and STS-103). During his final spaceflight he participated in a spacewalk, becoming the first European Space Agency astronaut to do so during a Space Shuttle mission. In 2000 he was assigned to the Astronaut Office Extravehicular Activity Branch, while maintaining a position as Lead ESA Astronaut in Houston. Nicollier retired from ESA in April 2007.",
    "wiki": "https://en.wikipedia.org/wiki/Claude_Nicollier",
    "last_flight": "1999-12-20T00:50:00Z",
    "first_flight": "1992-07-31T13:56:48Z",
    "social_media_links": [
        {
            "id": 196,
            "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/Astroclaude"
        }
    ],
    "flights_count": 4,
    "landings_count": 4,
    "spacewalks_count": 1,
    "flights": [],
    "landings": [],
    "spacewalks": []
}