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

{
    "id": 449,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/449/?format=api",
    "name": "John M. Grunsfeld",
    "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": 829,
        "name": "[AUTO] John M. Grunsfeld - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/john2520m.2520grunsfeld_image_20181202144850.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190903.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": "P58DT15H3M26S",
    "eva_time": "P2DT10H30M",
    "age": 66,
    "date_of_birth": "1958-10-10",
    "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": "John Mace Grunsfeld is an American physicist and a former NASA astronaut. He is a veteran of five Space Shuttle flights and has served as NASA Chief Scientist. His academic background includes research in high energy astrophysics, cosmic ray physics and the emerging field of exoplanet studies with specific interest in future astronomical instrumentation. After retiring from NASA in 2009, he served as the Deputy Director of the Space Telescope Science Institute in Baltimore, Maryland. In January 2012, he returned to NASA and served as associate administrator of NASA's Science Mission Directorate (SMD). Grunsfeld announced his retirement from NASA in April 2016.",
    "wiki": "https://en.wikipedia.org/wiki/John_M._Grunsfeld",
    "last_flight": "2009-05-11T18:01:56Z",
    "first_flight": "1995-03-02T06:38:13Z",
    "social_media_links": [
        {
            "id": 85,
            "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/SciAstro"
        }
    ],
    "flights_count": 5,
    "landings_count": 5,
    "spacewalks_count": 8,
    "flights": [],
    "landings": [],
    "spacewalks": []
}