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

{
    "id": 653,
    "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/653/?format=api",
    "name": "Matthias Maurer",
    "status": {
        "id": 1,
        "name": "Active"
    },
    "agency": {
        "response_mode": "list",
        "id": 27,
        "url": "https://lldev.thespacedevs.com/2.3.0/agencies/27/?format=api",
        "name": "European Space Agency",
        "abbrev": "ESA",
        "type": {
            "id": 2,
            "name": "Multinational"
        }
    },
    "image": {
        "id": 567,
        "name": "[AUTO] Matthias Maurer - image",
        "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/matthias_maurer_image_20211001184714.jpg",
        "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190207.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": "P176DT2H39M29S",
    "eva_time": "PT6H54M",
    "age": 55,
    "date_of_birth": "1970-03-18",
    "date_of_death": null,
    "nationality": [
        {
            "id": 4,
            "name": "Germany",
            "alpha_2_code": "DE",
            "alpha_3_code": "DEU",
            "nationality_name": "German",
            "nationality_name_composed": "Germano"
        }
    ],
    "bio": "Maurer applied to the European Space Agency as an astronaut in 2008, but was not initially appointed to the European Astronaut Corps. He formally joined the European Astronaut Corps in July 2015. In March 2018, he gained certification to perform International Space Station-related spacewalks in the American spacesuit EMU. In 2018 he also successfully graduated from both basic astronaut training and pre-assignment training and thus became fully certified to go to space.\r\nOn 28 July 2020, Maurer was announced as a backup for Thomas Pesquet for the ISS expedition 65. His own flight is scheduled to take place no earlier than September 2021 aboard SpaceX Crew-3.",
    "wiki": "https://en.wikipedia.org/wiki/Matthias_Maurer",
    "last_flight": "2021-11-11T02:03:31Z",
    "first_flight": "2021-11-11T02:03:31Z",
    "social_media_links": [
        {
            "id": 5,
            "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_matthias"
        },
        {
            "id": 6,
            "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/esamatthiasmaurer"
        }
    ],
    "flights_count": 1,
    "landings_count": 1,
    "spacewalks_count": 1,
    "flights": [],
    "landings": [],
    "spacewalks": [
        {
            "response_mode": "list",
            "id": 435,
            "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/435/?format=api",
            "name": "Expedition 66 EVA 4",
            "start": "2022-03-23T12:32:00Z",
            "end": "2022-03-23T19:26:00Z",
            "duration": "PT6H54M",
            "location": "International Space Station",
            "crew": [
                {
                    "id": 4638,
                    "role": {
                        "id": 33,
                        "role": "EV1",
                        "priority": 0
                    },
                    "astronaut": {
                        "id": 576,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/576/?format=api",
                        "name": "Raja Chari",
                        "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": 640,
                            "name": "[AUTO] Raja Chari - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/raja_chari_image_20211001184813.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190402.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": "P176DT2H39M29S",
                        "eva_time": "PT13H49M",
                        "age": 47,
                        "date_of_birth": "1977-06-24",
                        "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": "Raja Jon Vurputoor Chari is an American test pilot and NASA astronaut of the class of 2017. He is a graduate of the U.S. Air Force Academy, MIT, and U.S. Naval Test Pilot School, and has over 2,000 flying hours.",
                        "wiki": "https://en.wikipedia.org/wiki/Raja_Chari",
                        "last_flight": "2021-11-11T02:03:31Z",
                        "first_flight": "2021-11-11T02:03:31Z",
                        "social_media_links": [
                            {
                                "id": 152,
                                "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_Raja"
                            },
                            {
                                "id": 153,
                                "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/astro_raja/"
                            }
                        ]
                    }
                },
                {
                    "id": 4639,
                    "role": {
                        "id": 34,
                        "role": "EV2",
                        "priority": 1
                    },
                    "astronaut": {
                        "id": 653,
                        "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/653/?format=api",
                        "name": "Matthias Maurer",
                        "status": {
                            "id": 1,
                            "name": "Active"
                        },
                        "agency": {
                            "response_mode": "list",
                            "id": 27,
                            "url": "https://lldev.thespacedevs.com/2.3.0/agencies/27/?format=api",
                            "name": "European Space Agency",
                            "abbrev": "ESA",
                            "type": {
                                "id": 2,
                                "name": "Multinational"
                            }
                        },
                        "image": {
                            "id": 567,
                            "name": "[AUTO] Matthias Maurer - image",
                            "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/matthias_maurer_image_20211001184714.jpg",
                            "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190207.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": "P176DT2H39M29S",
                        "eva_time": "PT6H54M",
                        "age": 55,
                        "date_of_birth": "1970-03-18",
                        "date_of_death": null,
                        "nationality": [
                            {
                                "id": 4,
                                "name": "Germany",
                                "alpha_2_code": "DE",
                                "alpha_3_code": "DEU",
                                "nationality_name": "German",
                                "nationality_name_composed": "Germano"
                            }
                        ],
                        "bio": "Maurer applied to the European Space Agency as an astronaut in 2008, but was not initially appointed to the European Astronaut Corps. He formally joined the European Astronaut Corps in July 2015. In March 2018, he gained certification to perform International Space Station-related spacewalks in the American spacesuit EMU. In 2018 he also successfully graduated from both basic astronaut training and pre-assignment training and thus became fully certified to go to space.\r\nOn 28 July 2020, Maurer was announced as a backup for Thomas Pesquet for the ISS expedition 65. His own flight is scheduled to take place no earlier than September 2021 aboard SpaceX Crew-3.",
                        "wiki": "https://en.wikipedia.org/wiki/Matthias_Maurer",
                        "last_flight": "2021-11-11T02:03:31Z",
                        "first_flight": "2021-11-11T02:03:31Z",
                        "social_media_links": [
                            {
                                "id": 5,
                                "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_matthias"
                            },
                            {
                                "id": 6,
                                "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/esamatthiasmaurer"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}