GET

Astronaut Instance

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

{
    "id": 746,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/746/?format=api",
    "name": "John McFall",
    "status": {
        "id": 3,
        "name": "In-Training"
    },
    "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": 685,
        "name": "[AUTO] John McFall - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/john_mcfall_image_20221123150741.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190512.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": "P0D",
    "eva_time": "P0D",
    "age": 43,
    "date_of_birth": "1981-04-25",
    "date_of_death": null,
    "nationality": [
        {
            "id": 10,
            "name": "United Kingdom",
            "alpha_2_code": "GB",
            "alpha_3_code": "GBR",
            "nationality_name": "British",
            "nationality_name_composed": "Brito"
        }
    ],
    "bio": "John has a background in sports and exercise science. He completed his bachelor’s degree from Swansea University, UK, in 2004, and his master’s degree from University of Wales Institute in Cardiff, UK, in 2005. \r\nIn 2014, John graduated with a Bachelor of Medicine and Surgery from the Cardiff University School of Medicine, UK. He became a member of the Royal College of Surgeons in 2016 and is currently a Trauma and Orthopaedic Specialist Registrar working in the south of England.\r\nFollowing a motorcycle accident that resulted in the amputation of his right leg at the age of 19, John learned to run again. He became a professional track and field athlete in 2005, going on to represent Great Britain and Northern Ireland as a Paralympic sprinter, class T42.",
    "wiki": "https://en.wikipedia.org/wiki/John_McFall_(athlete)",
    "last_flight": null,
    "first_flight": null,
    "social_media_links": [
        {
            "id": 34,
            "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/iamfivetoes"
        },
        {
            "id": 35,
            "social_media": {
                "id": 2,
                "name": "Instagram",
                "url": "https://instagram.com",
                "logo": {
                    "id": 2322,
                    "name": "Instagram logo",
                    "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/instagram_logo_image_20250211191139.png",
                    "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/instagram_logo_image_thumbnail_20250211191139.png",
                    "credit": "Instagram",
                    "license": {
                        "id": 1,
                        "name": "Unknown",
                        "priority": 9,
                        "link": null
                    },
                    "single_use": true,
                    "variants": []
                }
            },
            "url": "https://www.instagram.com/mrjohnmcfall/"
        }
    ],
    "flights_count": 0,
    "landings_count": 0,
    "spacewalks_count": 0,
    "flights": [],
    "landings": [],
    "spacewalks": []
}