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

{
    "id": 716,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/716/?format=api",
    "name": "Scott Poteet",
    "status": {
        "id": 3,
        "name": "In-Training"
    },
    "agency": {
        "response_mode": "list",
        "id": 121,
        "url": "https://lldev.thespacedevs.com/2.3.0/agencies/121/?format=api",
        "name": "SpaceX",
        "abbrev": "SpX",
        "type": {
            "id": 3,
            "name": "Commercial"
        }
    },
    "image": {
        "id": 487,
        "name": "[AUTO] Scott Poteet - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/scott_poteet_image_20220214140414.jpeg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190000.jpeg",
        "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": "P4DT22H13M5S",
    "eva_time": "P0D",
    "age": 55,
    "date_of_birth": "1970-01-01",
    "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": "Scott “Kidd” Poteet is a retired United States Air Force Lieutenant Colonel who served 20 years in various roles that include Commander of the 64th Aggressor Squadron, USAF Thunderbird #4 Demonstration Pilot, USAF Weapons School Graduate, Operational Test & Evaluation Pilot, and Flight Examiner. Kidd is a command pilot with over 3,200 flying hours in the F-16, A-4, T-38, T-37, T-3, and Alpha Jet. Kidd has logged over 400 hours of combat time during Operations Northern Watch, Southern Watch, Joint Guardian, Freedom’s Sentinel, and Resolute Support.\r\n\r\nFollowing his Air Force career, Kidd served in various roles to include Director of Business Development at Draken International and VP of Strategy at Shift4 (NYSE: FOUR). He most recently served as the Mission Director of Inspiration4. Kidd is also an accomplished collegiate runner and triathlete, competing in 15 Ironman triathlons since 2000, which includes four Ironman World Championships in Kailua-Kona, Hawaii.",
    "wiki": null,
    "last_flight": "2024-09-10T09:23:49Z",
    "first_flight": "2024-09-10T09:23:49Z",
    "social_media_links": [
        {
            "id": 30,
            "social_media": {
                "id": 1,
                "name": "X",
                "url": "https://x.com",
                "logo": {
                    "id": 2320,
                    "name": "X logo",
                    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/x_logo_image_20250211191027.jpg",
                    "thumbnail_url": "https://thespacedevs-dev.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/KiddPoteet"
        },
        {
            "id": 31,
            "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/kiddpoteet/"
        }
    ],
    "flights_count": 1,
    "landings_count": 1,
    "spacewalks_count": 0,
    "flights": [],
    "landings": [],
    "spacewalks": []
}