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

{
    "count": 853,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=838&ordering=-spacewalks_count",
    "results": [
        {
            "id": 595,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/595/?format=api",
            "name": "William A. Pailes",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "agency": {
                "response_mode": "list",
                "id": 161,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/161/?format=api",
                "name": "United States Air Force",
                "abbrev": "USAF",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 404,
                "name": "[AUTO] William A. Pailes - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/william2520a.2520pailes_image_20190211162601.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185751.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 5,
                "name": "Payload Specialist"
            },
            "in_space": false,
            "time_in_space": "P4DT1H44M30S",
            "eva_time": "P0D",
            "age": 73,
            "date_of_birth": "1952-06-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": "William Arthur Pailes (Colonel, USAF) (born June 26, 1952) was a USAF astronaut in the Manned Spaceflight Engineer Program during the mid-1980s. He served as a Payload Specialist on STS-51-J Atlantis (October 3–7, 1985).",
            "wiki": "https://en.wikipedia.org/wiki/William_A._Pailes",
            "last_flight": "1985-10-03T15:15:30Z",
            "first_flight": "1985-10-03T15:15:30Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "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-dev.nyc3.digitaloceanspaces.com/media/images/robert2520thirsk_image_20181201222354.jpg",
                "thumbnail_url": "https://thespacedevs-dev.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": 72,
            "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
        },
        {
            "id": 104,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/104/?format=api",
            "name": "Konstantin Feoktistov",
            "status": {
                "id": 11,
                "name": "Deceased"
            },
            "agency": {
                "response_mode": "list",
                "id": 63,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "abbrev": "RFSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 403,
                "name": "[AUTO] Konstantin Feoktistov - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/konstantin2520feoktistov_image_20181128231150.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185749.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": "P1DT17M3S",
            "eva_time": "P0D",
            "age": 83,
            "date_of_birth": "1926-02-07",
            "date_of_death": "2009-11-21",
            "nationality": [
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "bio": "Konstantin Petrovich Feoktistov (Russian: Константин Петрович Феоктистов; 7 February 1926 – 21 November 2009) was a Soviet cosmonaut and an eminent space engineer. Feoktistov also wrote several books on space technology and exploration. The Feoktistov crater on the far side of the Moon is named in his honor.",
            "wiki": "https://en.wikipedia.org/wiki/Konstantin_Feoktistov",
            "last_flight": "1964-10-12T07:30:01Z",
            "first_flight": "1964-10-12T07:30:01Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 118,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/118/?format=api",
            "name": "Umberto Guidoni",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "agency": {
                "response_mode": "list",
                "id": 27,
                "url": "https://lldev.thespacedevs.com/2.3.0/agencies/27/?format=api",
                "name": "European Space Agency",
                "abbrev": "ESA",
                "type": {
                    "id": 2,
                    "name": "Multinational"
                }
            },
            "image": {
                "id": 473,
                "name": "[AUTO] Umberto Guidoni - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/umberto2520guidoni_image_20181128233554.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185939.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": "P27DT15H10M18S",
            "eva_time": "P0D",
            "age": 71,
            "date_of_birth": "1954-08-18",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 3,
                    "name": "Italy",
                    "alpha_2_code": "IT",
                    "alpha_3_code": "ITA",
                    "nationality_name": "Italian",
                    "nationality_name_composed": "Italo"
                }
            ],
            "bio": "Umberto Guidoni (born 18 August 1954 in Rome) is an Italian astrophysicist, science writer and a former ESA astronaut, being the first European to visit the International Space Station. He is a veteran of two NASA space shuttle missions.",
            "wiki": "https://en.wikipedia.org/wiki/Umberto_Guidoni",
            "last_flight": "2001-04-19T18:40:42Z",
            "first_flight": "1996-02-22T20:18:00Z",
            "social_media_links": [],
            "flights_count": 2,
            "landings_count": 2,
            "spacewalks_count": 0
        },
        {
            "id": 316,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/316/?format=api",
            "name": "Jack Swigert",
            "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": 402,
                "name": "[AUTO] Jack Swigert - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/jack2520swigert_image_20190426143705.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185748.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": "P5DT22H53M57S",
            "eva_time": "P0D",
            "age": 51,
            "date_of_birth": "1931-08-30",
            "date_of_death": "1982-12-27",
            "nationality": [
                {
                    "id": 2,
                    "name": "United States of America",
                    "alpha_2_code": "US",
                    "alpha_3_code": "USA",
                    "nationality_name": "American",
                    "nationality_name_composed": "Americano"
                }
            ],
            "bio": "John Leonard \"Jack\" Swigert Jr. was an American test pilot, mechanical and aerospace engineer, United States Air Force pilot, and NASA astronaut. He was one of twenty-four astronauts who have flown to the Moon.[2][3]\r\n\r\nBefore joining NASA in 1966, Swigert was a civilian test pilot and fighter pilot in the Air National Guard. After leaving NASA, he was elected to Congress from Colorado's new 6th district, but died before being sworn in.",
            "wiki": "https://en.wikipedia.org/wiki/Jack_Swigert",
            "last_flight": "1970-04-11T19:13:03Z",
            "first_flight": "1970-04-11T19:13:03Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        }
    ]
}