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=last_flight
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=last_flight",
    "results": [
        {
            "id": 750,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/750/?format=api",
            "name": "Raphaël Liégeois",
            "status": {
                "id": 3,
                "name": "In-Training"
            },
            "agency": {
                "response_mode": "list",
                "id": 27,
                "url": "https://ll.thespacedevs.com/2.3.0/agencies/27/?format=api",
                "name": "European Space Agency",
                "abbrev": "ESA",
                "type": {
                    "id": 2,
                    "name": "Multinational"
                }
            },
            "image": {
                "id": 708,
                "name": "[AUTO] Raphaël Liégeois - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/rapha25c325ab_image_20221123151537.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190557.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": null,
            "date_of_birth": null,
            "date_of_death": null,
            "nationality": [
                {
                    "id": 20,
                    "name": "Belgium",
                    "alpha_2_code": "BE",
                    "alpha_3_code": "BEL",
                    "nationality_name": "Belgian",
                    "nationality_name_composed": "Belgo"
                }
            ],
            "bio": "Raphaël studied biomedical engineering at the University of Liège, Belgium, from 2005 to 2011. He also became Ingénieur Centralien as part of a double degree exchange programme with the École Centrale Paris, France, in 2009 and earned a master’s degree in fundamental physics from the University Paris-Sud Orsay, France, in 2010.\r\nFrom 2011 to 2015, he completed a Doctorate in neuroscience at the University of Liège, Belgium, where he developed mathematical models of brain function. \r\nFrom 2015 to 2017, he completed a post-doctoral research stay at the National University of Singapore, where his research aimed at defining new neuroimaging markers of neurodegenerative diseases. From 2018 to 2021, Raphaël was a senior post-doctoral research fellow with the École Polytechnique Fédérale de Lausanne, Switzerland, where he developed dynamic models of brain function. During this time, Raphaël was also a visiting research scholar at Stanford University, USA, in 2019. \r\n\r\nFrom 2021, Raphaël has been working as a Research and Teaching Fellow at the University of Geneva and the École Polytechnique Fédérale de Lausanne, Switzerland, where he taught neuroengineering and statistics courses, and pursued research on brain dynamics in health and disease. His research was awarded with several prizes and honours and he was active as organiser of multiple international courses and events.",
            "wiki": null,
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        },
        {
            "id": 714,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/714/?format=api",
            "name": "Christopher Williams",
            "status": {
                "id": 3,
                "name": "In-Training"
            },
            "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": 671,
                "name": "[AUTO] Christopher Williams - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/christopher_wil_image_20211206185420.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190450.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": 42,
            "date_of_birth": "1983-01-01",
            "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": "Christopher Williams grw up in Potomac, Maryland and graduated from Stanford University in 2005 with a bachelor’s degree in physics and a doctorate in physics from MIT in 2012, where his research was in astrophysics. Williams is a board-certified medical physicist, completing his residency training at Harvard Medical School before joining the faculty as a clinical physicist and researcher. He most recently worked as a medical physicist in the Radiation Oncology Department at the Brigham and Women's Hospital and Dana-Farber Cancer Institute in Boston. He was the lead physicist for the Institute’s MRI-guided adaptive radiation therapy program. His research focused on developing image guidance techniques for cancer treatments.\r\n\r\nExact date of birth unknown.",
            "wiki": "https://en.wikipedia.org/wiki/Christopher_Williams_(astronaut)",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        },
        {
            "id": 708,
            "url": "https://ll.thespacedevs.com/2.3.0/astronauts/708/?format=api",
            "name": "Christina Birch",
            "status": {
                "id": 3,
                "name": "In-Training"
            },
            "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": 559,
                "name": "[AUTO] Christina Birch - image",
                "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/christina_birch_image_20211206185347.jpg",
                "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190155.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": 38,
            "date_of_birth": "1986-11-17",
            "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": "Christina Birch grew up in Gilbert, Arizona, and graduated from the University of Arizona with a bachelor’s degree in mathematics and a bachelor’s degree in biochemistry and molecular biophysics. After earning a doctorate in biological engineering from MIT, she taught bioengineering at the University of California, Riverside, and scientific writing and communication at the California Institute of Technology. She became a decorated track cyclist on the US National Team.",
            "wiki": "https://en.wikipedia.org/wiki/Christina_Birch",
            "last_flight": null,
            "first_flight": null,
            "social_media_links": [
                {
                    "id": 42,
                    "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/huplikewhoa"
                },
                {
                    "id": 43,
                    "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/huplikewhoa"
                }
            ],
            "flights_count": 0,
            "landings_count": 0,
            "spacewalks_count": 0
        }
    ]
}