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=time_in_space
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=time_in_space",
    "results": [
        {
            "id": 217,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/217/?format=api",
            "name": "Gennady Padalka",
            "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": 811,
                "name": "[AUTO] Gennady Padalka - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/gennady2520padalka_image_20181201185148.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190835.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": "P878DT11H29M11S",
            "eva_time": "P1DT14H37M",
            "age": 66,
            "date_of_birth": "1958-06-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": "Gennady Ivanovich Padalka (Russian: Гeннадий Иванович Падалка; born 21 June 1958 in Krasnodar, Russia) is a Russian Air Force officer and an RKA cosmonaut. Padalka currently has the world record for the most time spent in space, having spent 879 days in space, more than any other person. He worked on both Mir and the International Space Station.",
            "wiki": "https://en.wikipedia.org/wiki/Gennady_Padalka",
            "last_flight": "2015-03-27T19:42:57Z",
            "first_flight": "1998-08-13T09:43:11Z",
            "social_media_links": [],
            "flights_count": 5,
            "landings_count": 5,
            "spacewalks_count": 10
        },
        {
            "id": 168,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/168/?format=api",
            "name": "Oleg Kononenko",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "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": 566,
                "name": "[AUTO] Oleg Kononenko - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/oleg2520kononenko_image_20181129233442.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190205.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": "P1110DT12H9M55S",
            "eva_time": "P1DT18H30M",
            "age": 60,
            "date_of_birth": "1964-06-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": "Oleg Dmitriyevich Kononenko (Russian: Олег Дмитриевич Кононенко) is a Russian cosmonaut. He has flown to the International Space Station three times, as a flight engineer for Expedition 17 aboard Soyuz TMA-12, as a flight engineer on Expedition 30 and commander of Expedition 31 aboard Soyuz TMA-03M, and as a flight engineer on Expedition 44 and Expedition 45 aboard Soyuz TMA-17M. Kononenko has accumulated over 533 days in orbit during three long duration flights to ISS.",
            "wiki": "https://en.wikipedia.org/wiki/Oleg_Kononenko",
            "last_flight": "2023-09-15T15:44:35Z",
            "first_flight": "2008-04-08T11:16:39Z",
            "social_media_links": [],
            "flights_count": 5,
            "landings_count": 5,
            "spacewalks_count": 7
        },
        {
            "id": 638,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/638/?format=api",
            "name": "Starman",
            "status": {
                "id": 1,
                "name": "Active"
            },
            "agency": {
                "response_mode": "list",
                "id": 121,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/121/?format=api",
                "name": "SpaceX",
                "abbrev": "SpX",
                "type": {
                    "id": 3,
                    "name": "Commercial"
                }
            },
            "image": {
                "id": 593,
                "name": "[AUTO] Starman - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/starman_image_20190307220126.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190247.jpeg",
                "credit": null,
                "license": {
                    "id": 1,
                    "name": "Unknown",
                    "priority": 9,
                    "link": null
                },
                "single_use": true,
                "variants": []
            },
            "response_mode": "normal",
            "type": {
                "id": 6,
                "name": "Non-Human"
            },
            "in_space": true,
            "time_in_space": "P2675DT5H29M47S",
            "eva_time": "P0D",
            "age": null,
            "date_of_birth": null,
            "date_of_death": null,
            "nationality": [
                {
                    "id": 17,
                    "name": "Unknown",
                    "alpha_2_code": "??",
                    "alpha_3_code": "???",
                    "nationality_name": "Earthling",
                    "nationality_name_composed": "Earthling"
                }
            ],
            "bio": "\"Starman\" is a mannequin dressed in a spacesuit occupying the driver's seat of Elon Musk's Tesla Roadster, launched to an heliocentric orbit on Falcon Heavy's inaugural launch.",
            "wiki": "https://en.wikipedia.org/wiki/Elon_Musk%27s_Tesla_Roadster",
            "last_flight": "2018-02-06T20:45:00Z",
            "first_flight": "2018-02-06T20:45:00Z",
            "social_media_links": [
                {
                    "id": 95,
                    "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/Tesla_Starman"
                },
                {
                    "id": 96,
                    "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/starman_by_spacex/"
                }
            ],
            "flights_count": 1,
            "landings_count": 0,
            "spacewalks_count": 0
        }
    ]
}