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

{
    "count": 813,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=800&ordering=-flights_count",
    "results": [
        {
            "id": 143,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/143/?format=api",
            "name": "Kathryn \"Kay\" Hire",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "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": 815,
                "name": "[AUTO] Kathryn \"Kay\" Hire - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/kathryn25202522kay25222520hire_image_20181129210202.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190841.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": 65,
            "date_of_birth": "1959-09-26",
            "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": "Kathryn Patricia \"Kay\" Hire is a NASA astronaut and Captain in the U.S. Navy Reserve who has flown aboard two Space Shuttle missions. Hire began work at the Kennedy Space Center in May 1989,first as an Orbiter Processing Facility 3 Activation Engineer selected by NASA in December 1994.",
            "wiki": "https://en.wikipedia.org/wiki/Kathryn_P._Hire",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        },
        {
            "id": 708,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/708/?format=api",
            "name": "Christina Birch",
            "status": {
                "id": 3,
                "name": "In-Training"
            },
            "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": 559,
                "name": "[AUTO] Christina Birch - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/christina_birch_image_20211206185347.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190155.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": 38,
            "date_of_birth": "1986-11-17",
            "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": "Christina Birch grew up in Gilbert, Arizona, and graduated from the University of Arizona with a bachelor’s degree in mathematics and a bachelor’s degree in biochemistry and molecular biophysics. After earning a doctorate in biological engineering from MIT, she taught bioengineering at the University of California, Riverside, and scientific writing and communication at the California Institute of Technology. She became a decorated track cyclist on the US National Team.",
            "wiki": "https://en.wikipedia.org/wiki/Christina_Birch",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [
                {
                    "id": 42,
                    "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/huplikewhoa"
                },
                {
                    "id": 43,
                    "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/huplikewhoa"
                }
            ],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        },
        {
            "id": 662,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/662/?format=api",
            "name": "Johanna Maislinger",
            "status": {
                "id": 3,
                "name": "In-Training"
            },
            "agency": null,
            "image": null,
            "response_mode": "normal",
            "type": {
                "id": 3,
                "name": "Private"
            },
            "in_space": false,
            "time_in_space": "P0D",
            "eva_time": "P0D",
            "age": 39,
            "date_of_birth": "1985-10-23",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 11,
                    "name": "Austria",
                    "alpha_2_code": "AT",
                    "alpha_3_code": "AUT",
                    "nationality_name": "Austrian",
                    "nationality_name_composed": "Austro"
                }
            ],
            "bio": "Johanna Maislinger is an Austrian aviator and engineer, currently employed by with the German cargo carrier Aerologic. She will go to the International Space Station as a space tourist on Soyuz MS-20.",
            "wiki": "https://en.wikipedia.org/wiki/Johanna_Maislinger",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        }
    ]
}