Astronaut List
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
Search
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=860&ordering=-time_in_space
{ "count": 862, "next": null, "previous": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=850&ordering=-time_in_space", "results": [ { "id": 496, "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/496/?format=api", "name": "Yvonne Cagle", "status": { "id": 2, "name": "Retired" }, "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": 294, "name": "[AUTO] Yvonne Cagle - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/yvonne2520cagle_image_20181203155449.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185448.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": 67, "date_of_birth": "1959-04-24", "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": "Yvonne Darlene Cagle is an American astronaut.", "wiki": "https://en.wikipedia.org/wiki/Yvonne_Cagle", "last_flight": null, "first_flight": null, "social_media_links": [ { "id": 162, "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/AstroMD_Yvonne" } ], "flights_count": 0, "landings_count": 0, "spacewalks_count": 0 }, { "id": 672, "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/672/?format=api", "name": "Mark Stucky", "status": { "id": 2, "name": "Retired" }, "agency": { "response_mode": "list", "id": 1024, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1024/?format=api", "name": "Virgin Galactic", "abbrev": "VG", "type": { "id": 5, "name": "Private" } }, "image": { "id": 751, "name": "[AUTO] Mark Stucky - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/mark_stucky_image_20210522145002.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190703.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "response_mode": "normal", "type": { "id": 3, "name": "Private" }, "in_space": false, "time_in_space": "P0D", "eva_time": "P0D", "age": 67, "date_of_birth": "1958-11-09", "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": "Mark P. \"Forger\" Stucky was an American test pilot and commercial astronaut for Virgin Galactic. He left the company in July 2021.", "wiki": "https://en.wikipedia.org/wiki/Mark_P._Stucky", "last_flight": "2020-06-25T12:00:00Z", "first_flight": "2010-10-28T12:00:00Z", "social_media_links": [], "flights_count": 30, "landings_count": 30, "spacewalks_count": 0 } ] }
