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

{
    "count": 824,
    "next": null,
    "previous": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=810&ordering=-time_in_space",
    "results": [
        {
            "id": 642,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/642/?format=api",
            "name": "Joshua Kutryk",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "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": 478,
                "name": "[AUTO] Joshua Kutryk - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/joshua2520kutryk_image_20191228095953.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185947.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": 43,
            "date_of_birth": "1982-03-21",
            "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": "Joshua Kutryk, a Royal Canadian Air Force lieutenant colonel, is from Beauvallon, Alberta. He has a bachelor’s degree in mechanical engineering, as well as master’s degrees in space studies, flight test engineering, and defense studies. Prior to joining CSA, Kutryk worked as an experimental test pilot and a fighter pilot in Cold Lake, Alberta, where he led the unit responsible for the operational flight-testing of fighter aircraft in Canada.",
            "wiki": "https://en.wikipedia.org/wiki/Joshua_Kutryk",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [
                {
                    "id": 66,
                    "social_media": {
                        "id": 1,
                        "name": "X",
                        "url": "https://x.com",
                        "logo": {
                            "id": 2320,
                            "name": "X logo",
                            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/x_logo_image_20250211191027.jpg",
                            "thumbnail_url": "https://thespacedevs-dev.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/astro_kutryk"
                },
                {
                    "id": 67,
                    "social_media": {
                        "id": 2,
                        "name": "Instagram",
                        "url": "https://instagram.com",
                        "logo": {
                            "id": 2322,
                            "name": "Instagram logo",
                            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/instagram_logo_image_20250211191139.png",
                            "thumbnail_url": "https://thespacedevs-dev.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/astro_kutryk/"
                }
            ],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        },
        {
            "id": 302,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/302/?format=api",
            "name": "John S. Bull",
            "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": 869,
                "name": "[AUTO] John S. Bull - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/john2520s.2520bull_image_20190426143712.jpeg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191009.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": 73,
            "date_of_birth": "1934-09-25",
            "date_of_death": "2008-08-11",
            "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 Sumter Bull, Ph.D. was an American naval officer and aviator, fighter pilot, test pilot, mechanical and aeronautical engineer, and NASA astronaut.",
            "wiki": "https://en.wikipedia.org/wiki/John_S._Bull",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        },
        {
            "id": 192,
            "url": "https://lldev.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://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": 868,
                "name": "[AUTO] Ravish Malhotra - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/ravish2520malhotra_image_20181201174749.jpg",
                "thumbnail_url": "https://thespacedevs-dev.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": 645,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/645/?format=api",
            "name": "Andrei Babkin",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "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": 226,
                "name": "[AUTO] Andrei Babkin - image",
                "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/andrei2520babkin_image_20200129210447.jpg",
                "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185251.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": 56,
            "date_of_birth": "1969-04-21",
            "date_of_death": null,
            "nationality": [
                {
                    "id": 5,
                    "name": "Russia",
                    "alpha_2_code": "RU",
                    "alpha_3_code": "RUS",
                    "nationality_name": "Russian",
                    "nationality_name_composed": "Russo"
                }
            ],
            "bio": "Andrei Nikolaevich Babkin (Russian: Андре́й Никола́евич Ба́бкин) is a Russian Engineer and Cosmonaut who was selected in April 2010.",
            "wiki": "https://en.wikipedia.org/wiki/Andrei_Babkin",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        }
    ]
}