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

{
    "id": 488,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/488/?format=api",
    "name": "Mark Kelly",
    "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": 617,
        "name": "[AUTO] Mark Kelly - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mark_kelly_image_20220911033551.jpeg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190324.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": "P54DT2H3M57S",
    "eva_time": "P0D",
    "age": 61,
    "date_of_birth": "1964-02-21",
    "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": "Mark Edward Kelly is a retired American astronaut, engineer, and retired U.S. Navy Captain. He is the husband of former Congresswoman Gabrielle Giffords, and is an author, political activist, and aerospace executive and consultant.\r\n\r\nA naval aviator, Kelly flew combat missions during the Gulf War. He was selected to become a NASA Space Shuttle pilot in 1996 and flew his first mission in 2001 as pilot of STS-108. He piloted STS-121 in 2006 and commanded STS-124 in 2008 and STS-134 in 2011. STS-134 was his final mission and the final mission of Space Shuttle Endeavour.\r\n\r\nHis wife was the target of an attempted assassination in Tucson, Arizona, on January 8, 2011. After the shooting, in which six people were killed, both Kelly and Giffords were thrust into the media spotlight. His wife's shooting led to a broad national conversation ranging from the duties of a husband to what is acceptable civil discourse.\r\n\r\nKelly's identical twin brother, Scott Kelly, is also an astronaut. The Kelly brothers are the only known siblings to have both traveled in space. In 2015, Scott Kelly began a mission spending a year in space on the International Space Station. He returned to Earth on March 1, 2016, after 340 days in space. During and after Scott's year-long mission, the brothers were studied to find physical differences caused by living in space versus a baseline on Earth.",
    "wiki": "https://en.wikipedia.org/wiki/Mark_Kelly",
    "last_flight": "2011-05-16T12:56:28Z",
    "first_flight": "2001-12-05T22:19:28Z",
    "social_media_links": [
        {
            "id": 48,
            "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/ShuttleCDRKelly"
        },
        {
            "id": 49,
            "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/shuttlecdrkelly/"
        }
    ],
    "flights_count": 4,
    "landings_count": 4,
    "spacewalks_count": 0,
    "flights": [],
    "landings": [],
    "spacewalks": []
}