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

{
    "count": 824,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=812&ordering=-landings_count",
    "results": [
        {
            "id": 841,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/841/?format=api",
            "name": "Jie Wang",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "agency": {
                "response_mode": "list",
                "id": 17,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api",
                "name": "China National Space Administration",
                "abbrev": "CNSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": null,
            "response_mode": "normal",
            "type": {
                "id": 2,
                "name": "Government"
            },
            "in_space": true,
            "time_in_space": "P93DT16H33M12S",
            "eva_time": "P0D",
            "age": 35,
            "date_of_birth": "1989-09-01",
            "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": "Wang Jie is a Chinese astronaut selected as part of the Shenzhou program. He joined the Chinese Communist Party (CCP) in June 2009 and enlisted in the People's Liberation Army (PLA) in January 2021. Prior to being chosen into the astronaut corps, he worked as a engineer at the China Aerospace Science and Technology Corporation (CASC).",
            "wiki": null,
            "last_flight": "2025-04-24T09:17:31Z",
            "first_flight": "2025-04-24T09:17:31Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 0,
            "spacewalks_count": 0
        },
        {
            "id": 858,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/858/?format=api",
            "name": "Justin Sun",
            "status": {
                "id": 14,
                "name": "Occasional Spaceflight"
            },
            "agency": {
                "response_mode": "list",
                "id": 141,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/141/?format=api",
                "name": "Blue Origin",
                "abbrev": "BO",
                "type": {
                    "id": 3,
                    "name": "Commercial"
                }
            },
            "image": {
                "id": 2424,
                "name": "Justin Sun image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/justin_sun_imag_image_20250721165133.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/justin_sun_imag_image_thumbnail_20250721165133.jpeg",
                "credit": "Blue Origin",
                "license": {
                    "id": 37,
                    "name": "Blue Origin Terms of Use",
                    "priority": 6,
                    "link": "https://www.blueorigin.com/terms-of-use"
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 3,
                "name": "Private"
            },
            "in_space": false,
            "time_in_space": "P0D",
            "eva_time": "P0D",
            "age": null,
            "date_of_birth": null,
            "date_of_death": null,
            "nationality": [
                {
                    "id": 6,
                    "name": "China",
                    "alpha_2_code": "CN",
                    "alpha_3_code": "CHN",
                    "nationality_name": "Chinese",
                    "nationality_name_composed": "Sino"
                },
                {
                    "id": 102,
                    "name": "Saint Kitts and Nevis",
                    "alpha_2_code": "KN",
                    "alpha_3_code": "KNA",
                    "nationality_name": "Kittitian",
                    "nationality_name_composed": "Kittitian"
                }
            ],
            "bio": "Justin Sun is a Chinese-born Kittitian crypto billionaire and businessperson. He is the founder of TRON, a cryptocurrency with an associated blockchain DAO ecosystem and USDD, a stablecoin issued by TRON DAO Reserve.",
            "wiki": "https://en.wikipedia.org/wiki/Justin_Sun",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [
                {
                    "id": 302,
                    "social_media": {
                        "id": 3,
                        "name": "Homepage",
                        "url": null,
                        "logo": null
                    },
                    "url": "https://www.hejustinsun.com/"
                },
                {
                    "id": 303,
                    "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://x.com/justinsuntron"
                },
                {
                    "id": 304,
                    "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/justinsun/"
                },
                {
                    "id": 305,
                    "social_media": {
                        "id": 4,
                        "name": "LinkedIn",
                        "url": "https://www.linkedin.com/",
                        "logo": {
                            "id": 2321,
                            "name": "LinkedIn logo",
                            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/linkedin_logo_image_20250211191111.png",
                            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/linkedin_logo_image_thumbnail_20250211191112.png",
                            "credit": "LinkedIn",
                            "license": {
                                "id": 1,
                                "name": "Unknown",
                                "priority": 9,
                                "link": null
                            },
                            "single_use": true,
                            "variants": []
                        }
                    },
                    "url": "https://www.linkedin.com/in/justinsuntron/"
                }
            ],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        }
    ]
}