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

{
    "id": 727,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/727/?format=api",
    "name": "Hamish Harding",
    "status": {
        "id": 14,
        "name": "Occasional Spaceflight"
    },
    "agency": {
        "response_mode": "list",
        "id": 141,
        "url": "https://lldev.thespacedevs.com/2.3.0/agencies/141/?format=api",
        "name": "Blue Origin",
        "abbrev": "BO",
        "type": {
            "id": 3,
            "name": "Commercial"
        }
    },
    "image": {
        "id": 485,
        "name": "[AUTO] Hamish Harding - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/hamish_harding_image_20220911034237.png",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185957.png",
        "credit": null,
        "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
        },
        "single_use": true,
        "variants": []
    },
    "response_mode": "detailed",
    "type": {
        "id": 3,
        "name": "Private"
    },
    "in_space": false,
    "time_in_space": "PT10M45S",
    "eva_time": "P0D",
    "age": 58,
    "date_of_birth": "1964-06-24",
    "date_of_death": "2023-06-18",
    "nationality": [
        {
            "id": 10,
            "name": "United Kingdom",
            "alpha_2_code": "GB",
            "alpha_3_code": "GBR",
            "nationality_name": "British",
            "nationality_name_composed": "Brito"
        }
    ],
    "bio": "Hamish was Chairman of Action Aviation, a business jet brokerage company he founded in 2004, and also a business jet pilot. In 2019, he and former International Space Station Commander Col. Terry Virts broke the Round-the-World record in a Gulfstream G650ER for any aircraft flying over the North and South poles. In addition to holding several aviation world records, Hamish has travelled to the South Pole twice, and in 2021 dived the Challenger Deep with Victor Vescovo to a depth of 36,000 ft in a two-person sub.\r\n\r\nHamish passed away on June 18th 2023 aboard the OceanGate Titan submersible while conducting a dive to the Titanic.",
    "wiki": "https://wikitia.com/wiki/Hamish_Harding",
    "last_flight": "2022-06-04T13:25:02Z",
    "first_flight": "2022-06-04T13:25:02Z",
    "social_media_links": [
        {
            "id": 12,
            "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/actionaviation0"
        },
        {
            "id": 13,
            "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/actionaviationchairman"
        }
    ],
    "flights_count": 1,
    "landings_count": 1,
    "spacewalks_count": 0,
    "flights": [],
    "landings": [],
    "spacewalks": []
}