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

{
    "id": 387,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/387/?format=api",
    "name": "James C. Adamson",
    "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": 781,
        "name": "[AUTO] James C. Adamson - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/james2520c.2520adamson_image_20181202133720.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190748.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": "P13DT22H21M",
    "eva_time": "P0D",
    "age": 79,
    "date_of_birth": "1946-03-03",
    "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": "James Craig Adamson is a former NASA astronaut and retired Colonel of the United States Army. He is married with 3 children. James Adamson flew on two missions, STS-28 and STS-43, and completed 263 orbits and 334 hours in space. After retiring from NASA, he was recruited by Allied Signal (later merged with Honeywell) where he retired in 2001. Adamson has logged over 3,000 hours in over 30 different types of helicopters and airplanes.",
    "wiki": "https://en.wikipedia.org/wiki/James_C._Adamson",
    "last_flight": "1991-08-02T15:02:00Z",
    "first_flight": "1989-08-08T12:37:00Z",
    "social_media_links": [],
    "flights_count": 2,
    "landings_count": 2,
    "spacewalks_count": 0,
    "flights": [],
    "landings": [],
    "spacewalks": []
}