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=-eva_time
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=-eva_time",
    "results": [
        {
            "id": 736,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/736/?format=api",
            "name": "Vanessa O’Brien",
            "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": 442,
                "name": "[AUTO] Vanessa O’Brien - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/vanessa_o25e2_image_20220911033839.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185849.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": "PT10M20S",
            "eva_time": "P0D",
            "age": 60,
            "date_of_birth": "1964-12-02",
            "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"
                },
                {
                    "id": 10,
                    "name": "United Kingdom",
                    "alpha_2_code": "GB",
                    "alpha_3_code": "GBR",
                    "nationality_name": "British",
                    "nationality_name_composed": "Brito"
                }
            ],
            "bio": "Vanessa Audi Rhys O'Brien is a British and American mountaineer, explorer, aquanaut, author and former business executive. On June 12, 2020, O'Brien became the first woman to reach Earth's highest and lowest points, receiving a Guinness World Record. She became the first American woman to climb K2 and the first British woman to climb K2 (as a result of her dual nationality) on 28 July 2017, successfully leading a team of 12 members to the summit and back on her third attempt. She is a Fellow of the Royal Geographical Society (RGS) and a Member of The Scientific Exploration Society (SES).",
            "wiki": "https://en.wikipedia.org/wiki/Vanessa_O%27Brien",
            "last_flight": "2022-08-04T13:56:07Z",
            "first_flight": "2022-08-04T13:56:07Z",
            "social_media_links": [
                {
                    "id": 20,
                    "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/vobonline"
                },
                {
                    "id": 21,
                    "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/vobonline"
                }
            ],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 690,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/690/?format=api",
            "name": "Robert M. White",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "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": 867,
                "name": "[AUTO] Robert M. White - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/robert_white_image_20210801071813.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191006.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": "PT11M",
            "eva_time": "P0D",
            "age": 85,
            "date_of_birth": "1924-07-06",
            "date_of_death": "2010-03-17",
            "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 Michael \"Bob\" White was an American  electrical engineer, test pilot, fighter pilot, and astronaut who was one of twelve pilots that flew in the X-15 experimental spaceplane.",
            "wiki": "https://en.wikipedia.org/wiki/Robert_Michael_White",
            "last_flight": "1962-07-17T17:30:00Z",
            "first_flight": "1962-07-17T17:30:00Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 588,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/588/?format=api",
            "name": "Charles D. Walker",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "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": 565,
                "name": "[AUTO] Charles D. Walker - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/charles2520d.2520walker_image_20181207221334.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190204.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": "P19DT21H54M33S",
            "eva_time": "P0D",
            "age": 76,
            "date_of_birth": "1948-08-29",
            "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": "Charles David \"Charlie\" Walker (born August 29, 1948) is an American engineer who flew on three Space Shuttle missions in 1984 and 1985 as a Payload Specialist for the McDonnell Douglas Corporation. He is the first non-government individual to fly in space.",
            "wiki": "https://en.wikipedia.org/wiki/Charles_D._Walker",
            "last_flight": "1985-11-27T00:29:00Z",
            "first_flight": "1984-08-30T12:41:50Z",
            "social_media_links": [],
            "flights_count": 3,
            "landings_count": 3,
            "spacewalks_count": 0
        }
    ]
}