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

{
    "count": 807,
    "next": "https://ll.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=400&ordering=status",
    "previous": "https://ll.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=380&ordering=status",
    "results": [
        {
            "id": 433,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/433/?format=api",
            "name": "William S. McArthur",
            "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": 897,
                "name": "[AUTO] William S. McArthur - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/william_s._mcar_image_20220911033830.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191057.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": "P224DT22H17M14S",
            "eva_time": "P1DT2H10M",
            "age": 73,
            "date_of_birth": "1951-07-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 Surles McArthur Jr. is a retired United States Army colonel and NASA astronaut and a veteran of three Space Shuttle missions and one expedition to the International Space Station via the Russian Soyuz capsule.",
            "wiki": "https://en.wikipedia.org/wiki/William_S._McArthur",
            "last_flight": "2005-10-01T03:54:53Z",
            "first_flight": "1993-10-18T14:53:10Z",
            "social_media_links": [],
            "flights_count": 4,
            "landings_count": 4,
            "spacewalks_count": 4
        },
        {
            "id": 376,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/376/?format=api",
            "name": "David Leestma",
            "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": 344,
                "name": "[AUTO] David Leestma - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/david2520leestma_image_20181202121039.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185617.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": "P22DT4H32M21S",
            "eva_time": "PT3H27M",
            "age": 76,
            "date_of_birth": "1949-05-06",
            "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": "David Cornell Leestma is a former American astronaut and retired Captain in the United States Navy.",
            "wiki": "https://en.wikipedia.org/wiki/David_Leestma",
            "last_flight": "1992-03-24T13:13:39Z",
            "first_flight": "1984-10-05T11:03:00Z",
            "social_media_links": [],
            "flights_count": 3,
            "landings_count": 3,
            "spacewalks_count": 1
        },
        {
            "id": 245,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/245/?format=api",
            "name": "Helen Sharman",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "agency": {
                "response_mode": "list",
                "id": 63,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "abbrev": "RFSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 908,
                "name": "[AUTO] Helen Sharman - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/helen2520sharman_image_20181201215642.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191113.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": "P7DT21H13M45S",
            "eva_time": "P0D",
            "age": 61,
            "date_of_birth": "1963-05-30",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 10,
                    "name": "United Kingdom",
                    "alpha_2_code": "GB",
                    "alpha_3_code": "GBR",
                    "nationality_name": "British",
                    "nationality_name_composed": "Brito"
                }
            ],
            "bio": "Helen Patricia Sharman, CMG, OBE, HonFRSC (born 30 May 1963) is a British chemist who became the first British astronaut and the first woman to visit the Mir space station in 1991.",
            "wiki": "https://en.wikipedia.org/wiki/Helen_Sharman",
            "last_flight": "1991-05-18T12:50:28Z",
            "first_flight": "1991-05-18T12:50:28Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 75,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/75/?format=api",
            "name": "Patrick Baudry",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "agency": {
                "response_mode": "list",
                "id": 46,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/46/?format=api",
                "name": "National Center of Space Research",
                "abbrev": "CNES",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 826,
                "name": "[AUTO] Patrick Baudry - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/patrick2520baudry_image_20181128222518.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190859.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": "P7DT1H38M",
            "eva_time": "P0D",
            "age": 79,
            "date_of_birth": "1946-03-06",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 1,
                    "name": "France",
                    "alpha_2_code": "FR",
                    "alpha_3_code": "FRA",
                    "nationality_name": "French",
                    "nationality_name_composed": "Franco"
                }
            ],
            "bio": "Patrick Pierre Roger Baudry (born March 6, 1946 in Cameroon), is a retired Lieutenant Colonel in the French Air Force and a former CNES astronaut. In 1985, he became the second French citizen in space, after Jean-Loup Chrétien, when he flew aboard NASA's Space Shuttle mission STS-51-G.",
            "wiki": "https://en.wikipedia.org/wiki/Patrick_Baudry",
            "last_flight": "1985-06-17T11:33:00Z",
            "first_flight": "1985-06-17T11:33:00Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 192,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/192/?format=api",
            "name": "Ravish Malhotra",
            "status": {
                "id": 2,
                "name": "Retired"
            },
            "agency": {
                "response_mode": "list",
                "id": 63,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/63/?format=api",
                "name": "Russian Federal Space Agency (ROSCOSMOS)",
                "abbrev": "RFSA",
                "type": {
                    "id": 1,
                    "name": "Government"
                }
            },
            "image": {
                "id": 868,
                "name": "[AUTO] Ravish Malhotra - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/ravish2520malhotra_image_20181201174749.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191007.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": 81,
            "date_of_birth": "1943-12-25",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 9,
                    "name": "India",
                    "alpha_2_code": "IN",
                    "alpha_3_code": "IND",
                    "nationality_name": "Indian",
                    "nationality_name_composed": "Indo"
                }
            ],
            "bio": "Ravish Malhotra (born 25 December 1943 born in Lahore, British India is a retired Air Commodore of the Indian Air Force.\r\nIn 1982, he was chosen to train for spaceflight in the Soviet Union's Intercosmos program. Malhotra served as backup for Rakesh Sharma on the Soyuz T-11 mission which launched the first Indian into space, but never went to space himself. Malhotra was awarded the Kirti Chakra in 1984.",
            "wiki": "https://en.wikipedia.org/wiki/Ravish_Malhotra",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        },
        {
            "id": 324,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/324/?format=api",
            "name": "Story Musgrave",
            "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": 645,
                "name": "[AUTO] Story Musgrave - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/story2520musgrave_image_20181202093148.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190410.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": "P54DT9H55M43S",
            "eva_time": "P1DT2H12M",
            "age": 89,
            "date_of_birth": "1935-08-19",
            "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": "Franklin Story Musgrave, M.D. is an American physician and a retired NASA astronaut. He is a public speaker[2] and consultant to both Disney's Imagineering group and Applied Minds in California. In 1996 he became only the second astronaut to fly on six spaceflights, and he is the most formally educated astronaut with six academic degrees.",
            "wiki": "https://en.wikipedia.org/wiki/Story_Musgrave",
            "last_flight": "1996-11-19T19:55:47Z",
            "first_flight": "1983-04-04T18:30:00Z",
            "social_media_links": [],
            "flights_count": 6,
            "landings_count": 6,
            "spacewalks_count": 4
        },
        {
            "id": 336,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/336/?format=api",
            "name": "John Oliver Creighton",
            "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": 941,
                "name": "[AUTO] John Oliver Creighton - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/john2520oliver2520creighton_image_20181202102551.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191204.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": "P16DT20H22M34S",
            "eva_time": "P0D",
            "age": 82,
            "date_of_birth": "1943-04-28",
            "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": "John Oliver Creighton is a former NASA astronaut who flew three Space Shuttle missions.",
            "wiki": "https://en.wikipedia.org/wiki/John_Oliver_Creighton",
            "last_flight": "1991-09-12T23:11:04Z",
            "first_flight": "1985-06-17T11:33:00Z",
            "social_media_links": [],
            "flights_count": 3,
            "landings_count": 3,
            "spacewalks_count": 0
        },
        {
            "id": 616,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/616/?format=api",
            "name": "James A. Pawelczyk",
            "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": 611,
                "name": "[AUTO] James A. Pawelczyk - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/james2520a.2520pawelczyk_image_20190211162428.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190315.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": "P15DT21H50M",
            "eva_time": "P0D",
            "age": 64,
            "date_of_birth": "1960-09-20",
            "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": "James Anthony \"Jim\" Pawelczyk (born September 20, 1960) is an American researcher of physiology and Kinesiology who flew aboard the NASA STS-90 Space Shuttle mission as a Payload Specialist.",
            "wiki": "https://en.wikipedia.org/wiki/James_A._Pawelczyk",
            "last_flight": "1998-04-17T18:19:00Z",
            "first_flight": "1998-04-17T18:19:00Z",
            "social_media_links": [],
            "flights_count": 1,
            "landings_count": 1,
            "spacewalks_count": 0
        },
        {
            "id": 391,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/391/?format=api",
            "name": "Marsha Ivins",
            "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": 506,
                "name": "[AUTO] Marsha Ivins - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/marsha_ivins_image_20220911034537.jpeg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190030.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": "P55DT21H46M46S",
            "eva_time": "P0D",
            "age": 74,
            "date_of_birth": "1951-04-15",
            "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": "Marsha Sue Ivins is an American former astronaut and a veteran of five space shuttle missions.",
            "wiki": "https://en.wikipedia.org/wiki/Marsha_Ivins",
            "last_flight": "2001-02-07T23:13:02Z",
            "first_flight": "1990-01-09T12:35:00Z",
            "social_media_links": [],
            "flights_count": 5,
            "landings_count": 5,
            "spacewalks_count": 0
        },
        {
            "id": 586,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/586/?format=api",
            "name": "Norman E. Thagard",
            "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": 213,
                "name": "[AUTO] Norman E. Thagard - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/norman2520e.2520thagard_image_20181207215117.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185231.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": "P140DT13H25M36S",
            "eva_time": "P0D",
            "age": 81,
            "date_of_birth": "1943-07-03",
            "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": "Norman Earl Thagard (born July 3, 1943), (Capt, USMC, Ret.), is an American scientist and former U.S. Marine Corps officer and naval aviator and NASA astronaut. He is the first American to ride to space on board a Russian vehicle, and can be considered the first American cosmonaut. He did on this on March 14, 1995, in the Soyuz TM-21 spacecraft for the Russian Mir-18 mission.",
            "wiki": "https://en.wikipedia.org/wiki/Norman_Thagard",
            "last_flight": "1995-03-14T06:11:34Z",
            "first_flight": "1983-06-18T11:33:00Z",
            "social_media_links": [],
            "flights_count": 5,
            "landings_count": 5,
            "spacewalks_count": 0
        }
    ]
}