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

{
    "count": 813,
    "next": null,
    "previous": "https://ll.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=800&ordering=-status",
    "results": [
        {
            "id": 1,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/1/?format=api",
            "name": "Thomas Pesquet",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "agency": {
                "response_mode": "list",
                "id": 27,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/27/?format=api",
                "name": "European Space Agency",
                "abbrev": "ESA",
                "type": {
                    "id": 2,
                    "name": "Multinational"
                }
            },
            "image": {
                "id": 637,
                "name": "[AUTO] Thomas Pesquet - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/thomas2520pesquet_image_20200102120546.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190357.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": "P396DT11H33M45S",
            "eva_time": "P1DT15H54M",
            "age": 47,
            "date_of_birth": "1978-02-27",
            "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": "Thomas Gautier Pesquet is a French aerospace engineer, pilot, and European Space Agency astronaut. Pesquet was selected by ESA as a candidate in May 2009, and he successfully completed his basic training in November 2010. From November 2016 to June 2017, Pesquet was part of Expeditions 50 and 51 on the International Space Station as a flight engineer.",
            "wiki": "https://en.wikipedia.org/wiki/Thomas_Pesquet",
            "last_flight": "2021-04-23T09:49:02Z",
            "first_flight": "2016-11-17T20:20:13Z",
            "social_media_links": [
                {
                    "id": 205,
                    "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/Thom_astro"
                },
                {
                    "id": 206,
                    "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/thom_astro"
                }
            ],
            "flights_count": 2,
            "landings_count": 2,
            "spacewalks_count": 6
        },
        {
            "id": 296,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/296/?format=api",
            "name": "Zhai Zhigang",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "agency": {
                "response_mode": "list",
                "id": 17,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/17/?format=api",
                "name": "China National Space Administration",
                "abbrev": "CNSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 392,
                "name": "[AUTO] Zhai Zhigang - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/zhai_zhigang_image_20211014075835.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185732.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": "P185DT5H59M37S",
            "eva_time": "PT12H58M",
            "age": 58,
            "date_of_birth": "1966-10-10",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 6,
                    "name": "China",
                    "alpha_2_code": "CN",
                    "alpha_3_code": "CHN",
                    "nationality_name": "Chinese",
                    "nationality_name_composed": "Sino"
                }
            ],
            "bio": "Zhai Zhigang (born October 10, 1966) is a major general in the People's Liberation Army Air Force and a CNSA astronaut. During the Shenzhou 7 mission in 2008, he became the first Chinese citizen to carry out a spacewalk.",
            "wiki": "https://en.wikipedia.org/wiki/Zhai_Zhigang",
            "last_flight": "2021-10-15T16:23:56Z",
            "first_flight": "2008-09-25T13:10:04Z",
            "social_media_links": [],
            "flights_count": 2,
            "landings_count": 2,
            "spacewalks_count": 3
        },
        {
            "id": 650,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/650/?format=api",
            "name": "Pyotr Dubrov",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "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": 463,
                "name": "[AUTO] Pyotr Dubrov - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/pyotr_dubrov_image_20201120155626.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185922.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": "P355DT3H45M19S",
            "eva_time": "P1DT5H49M",
            "age": 47,
            "date_of_birth": "1978-01-30",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "bio": "Dubrov was selected by Roscosmos as a cosmonaut on 8 October 2012, as one of eight cosmonauts selected as part of Roscosmos's 2012 selection group.\r\nIn 2020 he was assigned to the backup crew of Soyuz MS-17, backing up Russian cosmonaut Sergey Kud-Sverchkov as Flight Engineer on ISS Expedition 63/64",
            "wiki": "https://en.wikipedia.org/wiki/Pyotr_Dubrov",
            "last_flight": "2021-04-09T07:42:41Z",
            "first_flight": "2021-04-09T07:42:41Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 4
        }
    ]
}