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

{
    "id": 503,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/503/?format=api",
    "name": "Mike Massimino",
    "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": 210,
        "name": "[AUTO] Mike Massimino - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mike_massimino_image_20220911033638.jpeg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185226.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": "P23DT19H48M2S",
    "eva_time": "P1DT6H44M",
    "age": 62,
    "date_of_birth": "1962-08-19",
    "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": "Michael James Massimino is an American professor of mechanical engineering at Columbia University and a former NASA astronaut. He is the senior advisor of space programs at the Intrepid Sea, Air & Space Museum.\r\n\r\nEarly life Massimino was born August 19, 1962 in Oceanside, New York, and raised in Franklin Square, New York, both on Long Island. He graduated from H. Frank Carey Junior-Senior High School in Franklin Square, New York in 1980. He went on to attend Columbia University, graduating with a Bachelor of Science degree in Industrial Engineering in 1984. He then attended the Massachusetts Institute of Technology, graduating with a Master of Science degree in Mechanical Engineering and a Master of Science degree in Technology and Public Policy in 1988. He continued his education at MIT, earning a Degree of Mechanical Engineer in 1990 and a Doctor of Philosophy degree in Mechanical Engineering in 1992.",
    "wiki": "https://en.wikipedia.org/wiki/Mike_Massimino",
    "last_flight": "2009-05-11T18:01:56Z",
    "first_flight": "2002-03-01T11:22:02Z",
    "social_media_links": [
        {
            "id": 18,
            "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/Astro_Mike"
        },
        {
            "id": 19,
            "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/astromikemassimino/"
        }
    ],
    "flights_count": 2,
    "landings_count": 2,
    "spacewalks_count": 4,
    "flights": [],
    "landings": [],
    "spacewalks": []
}