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

{
    "id": 560,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/560/?format=api",
    "name": "Joseph M. Acaba",
    "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": 940,
        "name": "[AUTO] Joseph M. Acaba - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/joseph2520m.2520acaba_image_20181203171712.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191202.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": "P306DT34M51S",
    "eva_time": "PT19H46M",
    "age": 57,
    "date_of_birth": "1967-05-17",
    "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": "Joseph Michael \"Joe\" Acaba is an American educator, hydrogeologist, and NASA astronaut. In May 2004 he became the first person of Puerto Rican heritage to be named as a NASA astronaut candidate, when he was selected as a member of NASA Astronaut Training Group 19. He completed his training on February 10, 2006 and was assigned to STS-119, which flew from March 15 to March 28, 2009 to deliver the final set of solar arrays to the International Space Station. Acaba served as a Flight Engineer aboard the International Space Station, having launched on May 15, 2012. He arrived at the space station on May 17 and returned to Earth on September 17, 2012. Acaba returned to the International Space Station in 2017 as a member of Expedition 53/54.",
    "wiki": "https://en.wikipedia.org/wiki/Joseph_M._Acaba",
    "last_flight": "2017-09-12T21:17:02Z",
    "first_flight": "2009-03-15T23:43:44Z",
    "social_media_links": [
        {
            "id": 81,
            "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/AstroAcaba"
        }
    ],
    "flights_count": 3,
    "landings_count": 3,
    "spacewalks_count": 3,
    "flights": [],
    "landings": [],
    "spacewalks": [
        {
            "response_mode": "list",
            "id": 392,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/392/?format=api",
            "name": "Expedition 53 EVA 3",
            "start": "2017-10-20T11:47:00Z",
            "end": "2017-10-20T18:36:00Z",
            "duration": "PT6H49M",
            "location": "International Space Station",
            "crew": [
                {
                    "id": 4552,
                    "role": {
                        "id": 33,
                        "role": "EV1",
                        "priority": 0
                    },
                    "astronaut": {
                        "id": 553,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/553/?format=api",
                        "name": "Randolph Bresnik",
                        "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": 276,
                            "name": "[AUTO] Randolph Bresnik - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/randolph_bresni_image_20210210155627.jpeg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185418.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": "P149DT12H12M39S",
                        "eva_time": "P1DT8H",
                        "age": 57,
                        "date_of_birth": "1967-09-11",
                        "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": "Randolph James \"Komrade\" Bresnik is an officer in the United States Marine Corps and a NASA astronaut. A Marine Aviator by trade, Bresnik was selected as a member of NASA Astronaut Group 19 in May 2004.[5] First launched to space on STS-129. Served as Flight Engineer for Expedition 52, and as ISS Commander for Expedition 53.",
                        "wiki": "https://en.wikipedia.org/wiki/Randolph_Bresnik",
                        "last_flight": "2017-07-28T15:41:12Z",
                        "first_flight": "2009-11-16T19:28:09Z",
                        "social_media_links": [
                            {
                                "id": 114,
                                "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/astrokomrade"
                            },
                            {
                                "id": 115,
                                "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://instagram.com/AstroKomrade/"
                            }
                        ]
                    }
                },
                {
                    "id": 4553,
                    "role": {
                        "id": 34,
                        "role": "EV2",
                        "priority": 1
                    },
                    "astronaut": {
                        "id": 560,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/560/?format=api",
                        "name": "Joseph M. Acaba",
                        "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": 940,
                            "name": "[AUTO] Joseph M. Acaba - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/joseph2520m.2520acaba_image_20181203171712.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191202.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": "P306DT34M51S",
                        "eva_time": "PT19H46M",
                        "age": 57,
                        "date_of_birth": "1967-05-17",
                        "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": "Joseph Michael \"Joe\" Acaba is an American educator, hydrogeologist, and NASA astronaut. In May 2004 he became the first person of Puerto Rican heritage to be named as a NASA astronaut candidate, when he was selected as a member of NASA Astronaut Training Group 19. He completed his training on February 10, 2006 and was assigned to STS-119, which flew from March 15 to March 28, 2009 to deliver the final set of solar arrays to the International Space Station. Acaba served as a Flight Engineer aboard the International Space Station, having launched on May 15, 2012. He arrived at the space station on May 17 and returned to Earth on September 17, 2012. Acaba returned to the International Space Station in 2017 as a member of Expedition 53/54.",
                        "wiki": "https://en.wikipedia.org/wiki/Joseph_M._Acaba",
                        "last_flight": "2017-09-12T21:17:02Z",
                        "first_flight": "2009-03-15T23:43:44Z",
                        "social_media_links": [
                            {
                                "id": 81,
                                "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/AstroAcaba"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}