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

{
    "id": 706,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/706/?format=api",
    "name": "Nichole Ayers",
    "status": {
        "id": 1,
        "name": "Active"
    },
    "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": 280,
        "name": "[AUTO] Nichole Ayers - image",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/nichole_ayers_image_20211206185339.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185425.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": "P147DT16H29M32S",
    "eva_time": "PT5H44M",
    "age": 37,
    "date_of_birth": "1989-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": "Nichole Ayers is a US Air Force major who graduated from the US Air Force Academy in Colorado Springs in 2011 with a bachelor’s degree in mathematics with a minor in Russian. She later earned a master’s degree in computational and applied mathematics from Rice University. Ayers is an experienced combat aviator with more than 200 combat hours and more than 1,150 hours of total flight time in the T-38 and the F-22 Raptor fighter jet. Ayers led the first ever all-woman formation of the aircraft in combat.\r\n\r\nExact date of birth unknown.",
    "wiki": "https://en.wikipedia.org/wiki/Nichole_Ayers",
    "last_flight": "2025-03-14T23:03:48Z",
    "first_flight": "2025-03-14T23:03:48Z",
    "social_media_links": [
        {
            "id": 278,
            "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/Astro_Ayers"
        },
        {
            "id": 279,
            "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/astro_ayers"
        }
    ],
    "flights_count": 1,
    "landings_count": 1,
    "spacewalks_count": 1,
    "flights": [],
    "landings": [],
    "spacewalks": [
        {
            "response_mode": "list",
            "id": 486,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/486/?format=api",
            "name": "Expedition 73 EVA 1",
            "start": "2025-05-01T13:05:00Z",
            "end": "2025-05-01T18:49:00Z",
            "duration": "PT5H44M",
            "location": "International Space Station",
            "crew": [
                {
                    "id": 5099,
                    "role": {
                        "id": 33,
                        "role": "EV1",
                        "priority": 0
                    },
                    "astronaut": {
                        "id": 7,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/7/?format=api",
                        "name": "Anne McClain",
                        "status": {
                            "id": 1,
                            "name": "Active"
                        },
                        "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": 290,
                            "name": "[AUTO] Anne McClain - image",
                            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/anne2520mcclain_image_20181127210625.jpg",
                            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185442.jpeg",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "response_mode": "list",
                        "type": {
                            "id": 2,
                            "name": "Government"
                        },
                        "in_space": false,
                        "time_in_space": "P351DT4H57M40S",
                        "eva_time": "PT18H52M",
                        "age": 46,
                        "date_of_birth": "1979-06-07",
                        "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": "Anne Charlotte McClain is a lieutenant colonel in the U.S. Army currently assigned to NASA Astronaut Group 21.",
                        "wiki": "https://en.wikipedia.org/wiki/Anne_McClain",
                        "last_flight": "2025-03-14T23:03:48Z",
                        "first_flight": "2018-12-03T11:31:52Z",
                        "social_media_links": [
                            {
                                "id": 198,
                                "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/AstroAnnimal"
                            }
                        ]
                    }
                },
                {
                    "id": 5100,
                    "role": {
                        "id": 34,
                        "role": "EV2",
                        "priority": 1
                    },
                    "astronaut": {
                        "id": 706,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/706/?format=api",
                        "name": "Nichole Ayers",
                        "status": {
                            "id": 1,
                            "name": "Active"
                        },
                        "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": 280,
                            "name": "[AUTO] Nichole Ayers - image",
                            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/nichole_ayers_image_20211206185339.jpg",
                            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185425.jpeg",
                            "credit": null,
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        },
                        "response_mode": "list",
                        "type": {
                            "id": 2,
                            "name": "Government"
                        },
                        "in_space": false,
                        "time_in_space": "P147DT16H29M32S",
                        "eva_time": "PT5H44M",
                        "age": 37,
                        "date_of_birth": "1989-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": "Nichole Ayers is a US Air Force major who graduated from the US Air Force Academy in Colorado Springs in 2011 with a bachelor’s degree in mathematics with a minor in Russian. She later earned a master’s degree in computational and applied mathematics from Rice University. Ayers is an experienced combat aviator with more than 200 combat hours and more than 1,150 hours of total flight time in the T-38 and the F-22 Raptor fighter jet. Ayers led the first ever all-woman formation of the aircraft in combat.\r\n\r\nExact date of birth unknown.",
                        "wiki": "https://en.wikipedia.org/wiki/Nichole_Ayers",
                        "last_flight": "2025-03-14T23:03:48Z",
                        "first_flight": "2025-03-14T23:03:48Z",
                        "social_media_links": [
                            {
                                "id": 278,
                                "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/Astro_Ayers"
                            },
                            {
                                "id": 279,
                                "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/astro_ayers"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}