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

{
    "id": 880,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/880/?format=api",
    "name": "Katherine Spies",
    "status": {
        "id": 3,
        "name": "In-Training"
    },
    "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": 2615,
        "name": "Katherine Spies official portrait",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/katherine_spies_image_20251205154615.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/katherine_spies_image_thumbnail_20251205154615.jpeg",
        "credit": "NASA",
        "license": {
            "id": 4,
            "name": "NASA Image and Media Guidelines",
            "priority": 0,
            "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/"
        },
        "single_use": true,
        "variants": []
    },
    "response_mode": "detailed",
    "type": {
        "id": 2,
        "name": "Government"
    },
    "in_space": false,
    "time_in_space": "P0D",
    "eva_time": "P0D",
    "age": 44,
    "date_of_birth": "1981-09-09",
    "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": "NASA astronaut candidate, selected in 2025 to join the 24th class of astronauts at the US space agency. An AH-1 attack helicopter pilot and test pilot for the United States Marine Corps, she has logged more than 2,000 flight hours on over 30 types of aircraft, including more than 300 combat hours. A graduate of the U.S. Naval Test Pilot School, she is originally from California and served as director of flight test engineering at Gulfstream Aerospace prior to her selection by NASA.",
    "wiki": null,
    "last_flight": null,
    "first_flight": null,
    "social_media_links": [
        {
            "id": 376,
            "social_media": {
                "id": 2,
                "name": "Instagram",
                "url": "https://instagram.com",
                "logo": {
                    "id": 2322,
                    "name": "Instagram logo",
                    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/instagram_logo_image_20250211191139.png",
                    "thumbnail_url": "https://thespacedevs-dev.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/spiesinspace/"
        }
    ],
    "flights_count": 0,
    "landings_count": 0,
    "spacewalks_count": 0,
    "flights": [],
    "landings": [],
    "spacewalks": []
}