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=status
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=status",
    "results": [
        {
            "id": 885,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/885/?format=api",
            "name": "Jim Hendren",
            "status": {
                "id": 14,
                "name": "Occasional Spaceflight"
            },
            "agency": {
                "response_mode": "list",
                "id": 141,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/141/?format=api",
                "name": "Blue Origin",
                "abbrev": "BO",
                "type": {
                    "id": 3,
                    "name": "Commercial"
                }
            },
            "image": {
                "id": 2650,
                "name": "Jim Hendren portrait",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/jim_hendren_por_image_20260116171206.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/jim_hendren_por_image_thumbnail_20260116171206.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": "PT10M12S",
            "eva_time": "P0D",
            "age": null,
            "date_of_birth": null,
            "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": "Retired U.S. Air Force Colonel, former F-15 fighter pilot, and past Commander of the 157th Combat Operations Squadron, with multiple overseas combat deployments",
            "wiki": "https://en.wikipedia.org/wiki/Jim_Hendren",
            "last_flight": "2026-01-22T16:25:35Z",
            "first_flight": "2026-01-22T16:25:35Z",
            "social_media_links": [
                {
                    "id": 388,
                    "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://x.com/JimHendren1"
                }
            ],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 683,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/683/?format=api",
            "name": "Mark Bezos",
            "status": {
                "id": 14,
                "name": "Occasional Spaceflight"
            },
            "agency": {
                "response_mode": "list",
                "id": 141,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/141/?format=api",
                "name": "Blue Origin",
                "abbrev": "BO",
                "type": {
                    "id": 3,
                    "name": "Commercial"
                }
            },
            "image": {
                "id": 643,
                "name": "[AUTO] Mark Bezos - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mark_bezos_image_20220911034437.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190407.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 3,
                "name": "Private"
            },
            "in_space": false,
            "time_in_space": "PT10M",
            "eva_time": "P0D",
            "age": 57,
            "date_of_birth": "1968-05-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": "Mark Bezos is the Founder and General Partner at HighPost Capital and Director of Bezos Family Foundation.  Apart from this, he is also Senior Vice President of Communication and Marketing events at Robin Hood Foundation, a poverty-fighting charity organization. He is popularly known as the brother of Jeff Bezos.",
            "wiki": "https://en.wikipedia.org/wiki/Mark_Bezos",
            "last_flight": "2021-07-20T13:12:00Z",
            "first_flight": "2021-07-20T13:12:00Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 779,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/779/?format=api",
            "name": "Sol Alan Stern",
            "status": {
                "id": 14,
                "name": "Occasional Spaceflight"
            },
            "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": 325,
                "name": "[AUTO] Sol Alan Stern - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/sol_alan_stern_image_20231019172409.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185545.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 7,
                "name": "Commercial"
            },
            "in_space": false,
            "time_in_space": "PT16M",
            "eva_time": "P0D",
            "age": 68,
            "date_of_birth": "1957-11-22",
            "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": "Sol Alan Stern is an American engineer and planetary scientist. He is the principal investigator of the New Horizons mission to Pluto and the Chief Scientist at Moon Express.",
            "wiki": "https://en.wikipedia.org/wiki/Alan_Stern",
            "last_flight": "2023-11-02T15:44:00Z",
            "first_flight": "2023-11-02T15:44:00Z",
            "social_media_links": [
                {
                    "id": 68,
                    "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/AlanStern"
                }
            ],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        }
    ]
}