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=-spacewalks_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=-spacewalks_count",
    "results": [
        {
            "id": 692,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/692/?format=api",
            "name": "Robert A. Rushworth",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "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": 469,
                "name": "[AUTO] Robert A. Rushworth - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/robert_a._rushw_image_20210801072516.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185933.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 1,
                "name": "Unknown"
            },
            "in_space": false,
            "time_in_space": "PT10M",
            "eva_time": "P0D",
            "age": 68,
            "date_of_birth": "1924-10-09",
            "date_of_death": "1993-03-18",
            "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 Aitken \"Bob\" Rushworth was an American United States Air Force major general, World War II, Korean War and Vietnam War pilot, mechanical and aeronautical engineer, test pilot and astronaut. He flew the X-15 experimental spaceplane to over 50 miles in altitude on Flight 87.",
            "wiki": "https://en.wikipedia.org/wiki/Robert_A._Rushworth",
            "last_flight": "1963-06-27T17:56:00Z",
            "first_flight": "1963-06-27T17:56:00Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 475,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/475/?format=api",
            "name": "Michael P. Anderson",
            "status": {
                "id": 4,
                "name": "Lost In Flight"
            },
            "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": 400,
                "name": "[AUTO] Michael P. Anderson - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/michael_p._ande_image_20220911033800.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185745.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": "P24DT18H7M45S",
            "eva_time": "P0D",
            "age": 43,
            "date_of_birth": "1959-12-28",
            "date_of_death": "2003-02-01",
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "Michael Phillip Anderson was a United States Air Force officer and NASA astronaut. Anderson and his six fellow crew members were killed in the Space Shuttle Columbia disaster when the craft disintegrated during its re-entry into the Earth's atmosphere. Anderson served as the payload commander and lieutenant colonel in charge of science experiments on the Columbia. Anderson was posthumously awarded the Congressional Space Medal of Honor.",
            "wiki": "https://en.wikipedia.org/wiki/Michael_P._Anderson",
            "last_flight": "2003-01-16T15:39:00Z",
            "first_flight": "1998-01-23T02:48:15Z",
            "social_media_links": [],
            "flights_count": 2,
            "landings_count": 2,
            "spacewalks_count": 0
        },
        {
            "id": 265,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/265/?format=api",
            "name": "Robert Thirsk",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "agency": {
                "response_mode": "list",
                "id": 16,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/16/?format=api",
                "name": "Canadian Space Agency",
                "abbrev": "CSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 471,
                "name": "[AUTO] Robert Thirsk - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/robert2520thirsk_image_20181201222354.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185935.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": "P204DT18H30M7S",
            "eva_time": "P0D",
            "age": 71,
            "date_of_birth": "1953-08-17",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 26,
                    "name": "Canada",
                    "alpha_2_code": "CA",
                    "alpha_3_code": "CAN",
                    "nationality_name": "Canadian",
                    "nationality_name_composed": "Canado"
                }
            ],
            "bio": "Robert Brent Thirsk, OC OBC (born August 17, 1953) is a Canadian engineer and physician, and a former Canadian Space Agency astronaut. He holds the Canadian records for the longest space flight (187 days 20 hours) and the most time spent in space (204 days 18 hours).",
            "wiki": "https://en.wikipedia.org/wiki/Robert_Thirsk",
            "last_flight": "2009-05-27T10:34:53Z",
            "first_flight": "1996-06-20T14:49:00Z",
            "social_media_links": [],
            "flights_count": 2,
            "landings_count": 2,
            "spacewalks_count": 0
        }
    ]
}