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=810&ordering=-landings_count
{ "count": 813, "next": null, "previous": "https://lldev.thespacedevs.com/2.3.0/astronauts/?format=api&limit=10&offset=800&ordering=-landings_count", "results": [ { "id": 806, "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/806/?format=api", "name": "Tibor Kapu", "status": { "id": 1, "name": "Active" }, "agency": { "response_mode": "list", "id": 1088, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1088/?format=api", "name": "Hungarian Ministry of Foreign Affairs and Trade", "abbrev": "", "type": { "id": 1, "name": "Government" } }, "image": { "id": 2133, "name": "Tibor Kapu portrait", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tibor_kapu_port_image_20240803065636.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/tibor_kapu_port_image_thumbnail_20240803065640.jpeg", "credit": "MTI/KKM", "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": 33, "date_of_birth": "1991-11-05", "date_of_death": null, "nationality": [ { "id": 31, "name": "Hungary", "alpha_2_code": "HU", "alpha_3_code": "HUN", "nationality_name": "Hungarian", "nationality_name_composed": "Hungarian" } ], "bio": "Hungarian astronaut selected to participate in a private spaceflight to the ISS as part of the HUNOR program.", "wiki": null, "last_flight": null, "first_flight": null, "social_media_links": [ { "id": 218, "social_media": { "id": 4, "name": "LinkedIn", "url": "https://www.linkedin.com/", "logo": { "id": 2321, "name": "LinkedIn logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/linkedin_logo_image_20250211191111.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/linkedin_logo_image_thumbnail_20250211191112.png", "credit": "LinkedIn", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "url": "https://www.linkedin.com/in/kaptib91" } ], "flights_count": 0, "landings_count": 0, "spacewalks_count": 0 }, { "id": 746, "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/746/?format=api", "name": "John McFall", "status": { "id": 3, "name": "In-Training" }, "agency": { "response_mode": "list", "id": 27, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/27/?format=api", "name": "European Space Agency", "abbrev": "ESA", "type": { "id": 2, "name": "Multinational" } }, "image": { "id": 685, "name": "[AUTO] John McFall - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/john_mcfall_image_20221123150741.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190512.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": 44, "date_of_birth": "1981-04-25", "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": "John has a background in sports and exercise science. He completed his bachelor’s degree from Swansea University, UK, in 2004, and his master’s degree from University of Wales Institute in Cardiff, UK, in 2005. \r\nIn 2014, John graduated with a Bachelor of Medicine and Surgery from the Cardiff University School of Medicine, UK. He became a member of the Royal College of Surgeons in 2016 and is currently a Trauma and Orthopaedic Specialist Registrar working in the south of England.\r\nFollowing a motorcycle accident that resulted in the amputation of his right leg at the age of 19, John learned to run again. He became a professional track and field athlete in 2005, going on to represent Great Britain and Northern Ireland as a Paralympic sprinter, class T42.", "wiki": "https://en.wikipedia.org/wiki/John_McFall_(athlete)", "last_flight": null, "first_flight": null, "social_media_links": [ { "id": 34, "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/iamfivetoes" }, { "id": 35, "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/mrjohnmcfall/" } ], "flights_count": 0, "landings_count": 0, "spacewalks_count": 0 }, { "id": 847, "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/847/?format=api", "name": "Mark Rocket", "status": { "id": 14, "name": "Occasional Spaceflight" }, "agency": { "response_mode": "list", "id": 141, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/141/?format=api", "name": "Blue Origin", "abbrev": "BO", "type": { "id": 3, "name": "Commercial" } }, "image": { "id": 2405, "name": "Mark Rocket official portrait", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mark_rocket_off_image_20250601063403.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/mark_rocket_off_image_thumbnail_20250601063403.jpeg", "credit": "Blue Origin", "license": { "id": 37, "name": "Blue Origin Terms of Use", "priority": 6, "link": "https://www.blueorigin.com/terms-of-use" }, "single_use": true, "variants": [] }, "response_mode": "normal", "type": { "id": 3, "name": "Private" }, "in_space": false, "time_in_space": "P0D", "eva_time": "P0D", "age": null, "date_of_birth": null, "date_of_death": null, "nationality": [ { "id": 51, "name": "New Zealand", "alpha_2_code": "NZ", "alpha_3_code": "NZL", "nationality_name": "Kiwi", "nationality_name_composed": "Kiwi" } ], "bio": "New Zealand entrepreneur, aerospace executive, and the founder of Kea Aerospace.", "wiki": "https://en.wikipedia.org/wiki/Mark_Rocket", "last_flight": null, "first_flight": null, "social_media_links": [ { "id": 293, "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://x.com/rocketnz" }, { "id": 294, "social_media": { "id": 3, "name": "Homepage", "url": null, "logo": null }, "url": "https://www.keaaerospace.com/mark-rocket/" }, { "id": 295, "social_media": { "id": 4, "name": "LinkedIn", "url": "https://www.linkedin.com/", "logo": { "id": 2321, "name": "LinkedIn logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/linkedin_logo_image_20250211191111.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/linkedin_logo_image_thumbnail_20250211191112.png", "credit": "LinkedIn", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] } }, "url": "https://www.linkedin.com/in/mark-rocket-8727353/" } ], "flights_count": 0, "landings_count": 0, "spacewalks_count": 0 } ] }
