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

{
    "count": 853,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=838&ordering=-status",
    "results": [
        {
            "id": 536,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/536/?format=api",
            "name": "Douglas H. Wheelock",
            "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": 337,
                "name": "[AUTO] Douglas H. Wheelock - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/douglas_h._whee_image_20220911033623.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185606.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": "P178DT9H33M22S",
            "eva_time": "P1DT19H30M",
            "age": 65,
            "date_of_birth": "1960-05-05",
            "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": "Douglas Harry \"Wheels\" Wheelock is an American engineer and astronaut. He has flown in space twice, logging 178 days on the Space Shuttle, International Space Station, and Russian Soyuz. On July 12, 2011, Wheelock announced that he would be returning to active duty with the United States Army in support of Operation Enduring Freedom.",
            "wiki": "https://en.wikipedia.org/wiki/Douglas_H._Wheelock",
            "last_flight": "2010-06-15T21:35:19Z",
            "first_flight": "2007-10-23T15:38:19Z",
            "social_media_links": [],
            "flights_count": 2,
            "landings_count": 2,
            "spacewalks_count": 6
        },
        {
            "id": 643,
            "url": "https://lldev.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://lldev.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-dev.nyc3.digitaloceanspaces.com/media/images/jennifer2520sidey-gibbons_image_20191228100223.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.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-dev.nyc3.digitaloceanspaces.com/media/images/x_logo_image_20250211191027.jpg",
                            "thumbnail_url": "https://thespacedevs-dev.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-dev.nyc3.digitaloceanspaces.com/media/images/instagram_logo_image_20250211191139.png",
                            "thumbnail_url": "https://thespacedevs-dev.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": 279,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/279/?format=api",
            "name": "Roberto Vittori",
            "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": 336,
                "name": "[AUTO] Roberto Vittori - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/roberto2520vittori_image_20181201224249.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185604.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": "P35DT12H25M25S",
            "eva_time": "P0D",
            "age": 61,
            "date_of_birth": "1964-10-15",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 3,
                    "name": "Italy",
                    "alpha_2_code": "IT",
                    "alpha_3_code": "ITA",
                    "nationality_name": "Italian",
                    "nationality_name_composed": "Italo"
                }
            ],
            "bio": "Roberto Vittori (born 15 October 1964 in Viterbo) is an Italian air force officer and an ESA astronaut. After graduating from the Italian Accademia Aeronautica in 1989, Vittori flew in the Italian Air Force. He then trained as a test pilot in the United States.\r\n\r\nIn 1998, Vittori was selected by the ESA to join the European Astronaut Corps. Since then, he has participated in three spaceflights: the Soyuz TM-34/33 and Soyuz TMA-6/5 taxi flights to the ISS, as well as STS-134, the penultimate mission of the American Space Shuttle Program. He was the last non-American to fly aboard the shuttle.",
            "wiki": "https://en.wikipedia.org/wiki/Roberto_Vittori",
            "last_flight": "2011-05-16T12:56:28Z",
            "first_flight": "2002-04-25T06:26:35Z",
            "social_media_links": [],
            "flights_count": 3,
            "landings_count": 3,
            "spacewalks_count": 0
        },
        {
            "id": 99,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/99/?format=api",
            "name": "Léopold Eyharts",
            "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": 332,
                "name": "[AUTO] Léopold Eyharts - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/l25c325a9opold2520eyharts_image_20181128230321.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185558.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": "P68DT21H30M48S",
            "eva_time": "P0D",
            "age": 68,
            "date_of_birth": "1957-04-28",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 1,
                    "name": "France",
                    "alpha_2_code": "FR",
                    "alpha_3_code": "FRA",
                    "nationality_name": "French",
                    "nationality_name_composed": "Franco"
                }
            ],
            "bio": "Léopold Eyharts (born April 28, 1957) is a French Brigadier General in the French Air Force, an engineer and ESA astronaut.",
            "wiki": "https://en.wikipedia.org/wiki/L%C3%A9opold_Eyharts",
            "last_flight": "2008-02-07T19:45:30Z",
            "first_flight": "1998-01-29T16:33:42Z",
            "social_media_links": [],
            "flights_count": 2,
            "landings_count": 2,
            "spacewalks_count": 0
        },
        {
            "id": 142,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/142/?format=api",
            "name": "Robert Hines",
            "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": 329,
                "name": "[AUTO] Robert Hines - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/robert2520hines_image_20181129205955.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185553.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": "P170DT13H2M8S",
            "eva_time": "P0D",
            "age": 51,
            "date_of_birth": "1975-01-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": "Robert \"Bob\" Thomas Hines, Jr. is an American fighter pilot and NASA astronaut of the class of 2017.",
            "wiki": "https://en.wikipedia.org/wiki/Robert_Hines_(astronaut)",
            "last_flight": "2022-04-27T07:52:55Z",
            "first_flight": "2022-04-27T07:52:55Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        }
    ]
}