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 - ll.thespacedevs.com/docs

GET /2.3.0/astronauts/?format=api&offset=850&ordering=-flights_count
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
    "count": 853,
    "next": null,
    "previous": "https://ll.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=840&ordering=-flights_count",
    "results": [
        {
            "id": 643,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/643/?format=api",
            "name": "Jennifer Sidey-Gibbons",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "agency": {
                "response_mode": "list",
                "id": 16,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/16/?format=api",
                "name": "Canadian Space Agency",
                "abbrev": "CSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 746,
                "name": "[AUTO] Jennifer Sidey-Gibbons - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/jennifer2520sidey-gibbons_image_20191228100223.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190656.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": false,
            "time_in_space": "P0D",
            "eva_time": "P0D",
            "age": 37,
            "date_of_birth": "1988-08-03",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 26,
                    "name": "Canada",
                    "alpha_2_code": "CA",
                    "alpha_3_code": "CAN",
                    "nationality_name": "Canadian",
                    "nationality_name_composed": "Canado"
                }
            ],
            "bio": "Jennifer Sidey-Gibbons hails from Calgary, Alberta. She holds an honors bachelor's degree in mechanical engineering from McGill University in Montreal and a doctorate in engineering from the University of Cambridge. While at McGill, she conducted research on flame propagation in microgravity, in collaboration with CSA and the National Research Council Flight Research Laboratory. Prior to joining CSA, Sidey-Gibbons worked as an assistant professor in combustion in the Department of Engineering at Cambridge.",
            "wiki": "https://en.wikipedia.org/wiki/Jenni_Sidey",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [
                {
                    "id": 117,
                    "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_jenni"
                },
                {
                    "id": 118,
                    "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_jenni/"
                }
            ],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        },
        {
            "id": 81,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/81/?format=api",
            "name": "Valentin Bondarenko",
            "status": {
                "id": 5,
                "name": "Lost In Training"
            },
            "agency": {
                "response_mode": "list",
                "id": 63,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "abbrev": "RFSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 841,
                "name": "[AUTO] Valentin Bondarenko - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/valentin2520bondarenko_image_20181128223624.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190922.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": false,
            "time_in_space": "P0D",
            "eva_time": "P0D",
            "age": 24,
            "date_of_birth": "1937-02-16",
            "date_of_death": "1961-03-23",
            "nationality": [
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "bio": "Valentin Vasiliyevich Bondarenko (Ukrainian: Валентин Васильович Бондаренко, Russian: Валентин Васильевич Бондаренко; 16 February 1937 – 23 March 1961) was a Soviet fighter pilot selected in 1960 for training as a cosmonaut. He died as the result of burns sustained in a fire during a 15-day low-pressure endurance experiment in Moscow. The government concealed the death, along with Bondarenko's membership in the cosmonaut corps, until 1980. A crater on the Moon's far side is named after him.",
            "wiki": "https://en.wikipedia.org/wiki/Valentin_Bondarenko",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        },
        {
            "id": 54,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/54/?format=api",
            "name": "Curt Michel",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "agency": {
                "response_mode": "list",
                "id": 44,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/44/?format=api",
                "name": "National Aeronautics and Space Administration",
                "abbrev": "NASA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 273,
                "name": "[AUTO] Curt Michel - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/curt2520michel_image_20181128151119.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185412.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": false,
            "time_in_space": "P0D",
            "eva_time": "P0D",
            "age": 80,
            "date_of_birth": "1934-06-05",
            "date_of_death": "2015-02-26",
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Frank Curtis \"Curt\" Michel, Ph.D. was an American astrophysicist; a professor of astrophysics at Rice University in Houston, Texas; a former United States Air Force pilot; and a NASA astronaut.",
            "wiki": "https://en.wikipedia.org/wiki/Curt_Michel",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        }
    ]
}