Astronaut Instance
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/714/?format=api
{ "id": 714, "url": "https://lldev.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://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": 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": "detailed", "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, "flights": [], "landings": [ { "id": 881, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_flights/881/?format=api", "destination": "ISS", "mission_end": null, "spacecraft": { "response_mode": "normal", "id": 612, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft/612/?format=api", "name": "Soyuz MS-28", "serial_number": null, "is_placeholder": false, "image": { "id": 967, "name": "Soyuz MS in orbit (MS-19)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_thumbnail_20240313130407.jpeg", "credit": "ESA/NASA/T. Pesquet", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": false, "variants": [] }, "in_space": false, "time_in_space": "P0D", "time_docked": "P0D", "flights_count": 0, "mission_ends_count": 0, "status": { "id": 1, "name": "Active" }, "description": "Soyuz capsule planned to be used on the MS-28 mission to the ISS.", "spacecraft_config": { "response_mode": "normal", "id": 38, "url": "https://lldev.thespacedevs.com/2.3.0/spacecraft_configurations/38/?format=api", "name": "Soyuz MS", "type": { "id": 2, "name": "Capsule" }, "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" } }, "family": [ { "response_mode": "normal", "id": 1, "name": "Soyuz", "description": "Soyuz is a series of spacecraft which has been in service since the 1960s, having made more than 140 flights. It was designed for the Soviet space program by the Korolev Design Bureau (now Energia).", "manufacturer": { "response_mode": "list", "id": 1000, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/1000/?format=api", "name": "Energia", "abbrev": "OKB-1", "type": { "id": 1, "name": "Government" } }, "parent": null, "maiden_flight": "1966-11-28" } ], "in_use": true, "image": { "id": 967, "name": "Soyuz MS in orbit (MS-19)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_20240313130407.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_ms_in_orb_image_thumbnail_20240313130407.jpeg", "credit": "ESA/NASA/T. Pesquet", "license": { "id": 2, "name": "ESA Standard Licence", "priority": 2, "link": "https://www.esa.int/ESA_Multimedia/Terms_and_conditions_of_use_of_images_and_videos_available_on_the_esa_website" }, "single_use": false, "variants": [] } }, "fastest_turnaround": null }, "launch": { "id": "40beac6e-ce8e-4481-8cf9-56d1d9c48804", "url": "https://lldev.thespacedevs.com/2.3.0/launches/40beac6e-ce8e-4481-8cf9-56d1d9c48804/?format=api", "name": "Soyuz 2.1a | Soyuz MS-28", "response_mode": "normal", "slug": "soyuz-21a-soyuz-ms-28", "launch_designator": null, "status": { "id": 2, "name": "To Be Determined", "abbrev": "TBD", "description": "Current date is a placeholder or rough estimation based on unreliable or interpreted sources." }, "last_updated": "2024-12-16T18:34:37Z", "net": "2025-11-27T00:00:00Z", "net_precision": { "id": 5, "name": "Day", "abbrev": "DAY", "description": "The T-0 is expected on the given day." }, "window_end": "2025-11-27T00:00:00Z", "window_start": "2025-11-27T00:00:00Z", "image": { "id": 1828, "name": "[AUTO] Soyuz 2.1a - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_2.1a_image_20230805184309.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305193857.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "infographic": null, "probability": null, "weather_concerns": null, "failreason": "", "hashtag": null, "launch_service_provider": { "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" } }, "rocket": { "id": 8428, "configuration": { "response_mode": "list", "id": 24, "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/24/?format=api", "name": "Soyuz 2.1a", "families": [ { "response_mode": "list", "id": 147, "name": "Soyuz" }, { "response_mode": "list", "id": 190, "name": "Soyuz 2" } ], "full_name": "Soyuz 2.1a", "variant": "" } }, "mission": { "id": 7017, "name": "Soyuz MS-28", "type": "Human Exploration", "description": "Soyuz MS-28 will carry three cosmonauts and one astronaut to the International Space Station aboard the Soyuz spacecraft from the Baikonur Cosmodrome in Kazakhstan. The crew consists of Roscosmos cosmonauts Sergei Kud-Sverchkov, Sergei Mikayev and Oleg Platonov.", "image": null, "orbit": { "id": 8, "name": "Low Earth Orbit", "abbrev": "LEO", "celestial_body": { "response_mode": "list", "id": 1, "name": "Earth" } }, "agencies": [ { "response_mode": "normal", "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" }, "featured": true, "country": [ { "id": 5, "name": "Russia", "alpha_2_code": "RU", "alpha_3_code": "RUS", "nationality_name": "Russian", "nationality_name_composed": "Russo" } ], "description": "The Roscosmos State Corporation for Space Activities, commonly known as Roscosmos, is the governmental body responsible for the space science program of the Russian Federation and general aerospace research. Soyuz has many launch locations the Russian sites are Baikonur, Plesetsk and Vostochny however Ariane also purchases the vehicle and launches it from French Guiana.", "administrator": "Administrator: Yuri Borisov", "founding_year": 1992, "launchers": "Soyuz", "spacecraft": "Soyuz", "parent": null, "image": { "id": 25, "name": "[AUTO] Russian Federal Space Agency (ROSCOSMOS) - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_image_20190207032459.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184652.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "logo": { "id": 177, "name": "[AUTO] Russian Federal Space Agency (ROSCOSMOS) - logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_logo_20190207032459.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185118.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "social_logo": { "id": 89, "name": "[AUTO] Russian Federal Space Agency (ROSCOSMOS) - social_logo", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/russian2520federal2520space2520agency25202528roscosmos2529_nation_20230531052758.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184841.jpeg", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "total_launch_count": 331, "consecutive_successful_launches": 55, "successful_launches": 320, "failed_launches": 11, "pending_launches": 10, "consecutive_successful_landings": 0, "successful_landings": 0, "failed_landings": 0, "attempted_landings": 0, "successful_landings_spacecraft": 198, "failed_landings_spacecraft": 7, "attempted_landings_spacecraft": 205, "successful_landings_payload": 0, "failed_landings_payload": 1, "attempted_landings_payload": 1, "info_url": "http://en.roscosmos.ru/", "wiki_url": "http://en.wikipedia.org/wiki/Russian_Federal_Space_Agency", "social_media_links": [] } ], "info_urls": [], "vid_urls": [] }, "pad": { "id": 20, "url": "https://lldev.thespacedevs.com/2.3.0/pads/20/?format=api", "active": true, "agencies": [], "name": "31/6", "image": { "id": 1467, "name": "Soyuz 2.1a liftoff from pad 31/6 (Progress MS-25)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz25202.1a_image_20231231162517.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192846.jpeg", "credit": "Roscosmos", "license": { "id": 14, "name": "Roscosmos Image Use Policy", "priority": 3, "link": "https://www.roscosmos.ru/22650/" }, "single_use": true, "variants": [] }, "description": "", "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Baikonur_Cosmodrome_Site_31", "map_url": "https://www.google.com/maps?q=45.996034,63.564003", "latitude": 45.996034, "longitude": 63.564003, "country": { "id": 44, "name": "Kazakhstan", "alpha_2_code": "KZ", "alpha_3_code": "KAZ", "nationality_name": "Kazakh", "nationality_name_composed": "Kazakhstani" }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/pad_20_20200803143516.jpg", "total_launch_count": 422, "orbital_launch_attempt_count": 422, "fastest_turnaround": "P1DT23H9M9S", "location": { "response_mode": "normal", "id": 15, "url": "https://lldev.thespacedevs.com/2.3.0/locations/15/?format=api", "name": "Baikonur Cosmodrome, Republic of Kazakhstan", "celestial_body": { "response_mode": "normal", "id": 1, "name": "Earth", "type": { "id": 1, "name": "Planet" }, "diameter": 12742000.0, "mass": 5.972168e+24, "gravity": 9.80655, "length_of_day": "1 00:00:00", "atmosphere": true, "image": { "id": 2040, "name": "Earth (Apollo 17)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_thumbnail_20240402194305.jpeg", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "description": "Earth is the third planet from the Sun and the only astronomical object known to harbor life.", "wiki_url": "https://en.wikipedia.org/wiki/Earth", "total_attempted_launches": 7129, "successful_launches": 6587, "failed_launches": 542, "total_attempted_landings": 1089, "successful_landings": 1046, "failed_landings": 43 }, "active": true, "country": { "id": 44, "name": "Kazakhstan", "alpha_2_code": "KZ", "alpha_3_code": "KAZ", "nationality_name": "Kazakh", "nationality_name_composed": "Kazakhstani" }, "description": "The Baikonur Cosmodrome is a spaceport operated by Russia within Kazakhstan. Located in the Kazakh city of Baikonur, it is the largest operational space launch facility in terms of area. All Russian crewed spaceflights are launched from Baikonur.", "image": { "id": 2198, "name": "Soyuz launch pad at the Baikonur Cosmodrome", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_launch_pa_image_20240918150530.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_launch_pa_image_thumbnail_20240918150530.jpeg", "credit": "NASA/Bill Ingalls", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "map_image": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/map_images/location_15_20200803142517.jpg", "longitude": 63.305, "latitude": 45.965, "timezone_name": "Asia/Qyzylorda", "total_launch_count": 1555, "total_landing_count": 0 } }, "webcast_live": false, "program": [ { "response_mode": "normal", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/programs/17/?format=api", "name": "International Space Station", "image": { "id": 1874, "name": "[AUTO] International Space Station - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/international2_program_20201129184745.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194014.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": "https://www.nasa.gov/mission_pages/station/main/index.html", "wiki_url": "https://en.wikipedia.org/wiki/International_Space_Station_programme", "description": "The International Space Station programme is tied together by a complex set of legal, political and financial agreements between the sixteen nations involved in the project, governing ownership of the various components, rights to crewing and utilization, and responsibilities for crew rotation and resupply of the International Space Station. It was conceived in 1984 by President Ronald Reagan, during the Space Station Freedom project as it was originally called.", "agencies": [ { "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" } }, { "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" } }, { "response_mode": "list", "id": 37, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/37/?format=api", "name": "Japan Aerospace Exploration Agency", "abbrev": "JAXA", "type": { "id": 1, "name": "Government" } }, { "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" } }, { "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" } } ], "start_date": "1998-11-20T06:40:00Z", "end_date": null, "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } }, { "response_mode": "normal", "id": 8, "url": "https://lldev.thespacedevs.com/2.3.0/programs/8/?format=api", "name": "Soyuz", "image": { "id": 1892, "name": "[AUTO] Soyuz - image", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz_program_20201129185543.png", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194048.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "info_url": null, "wiki_url": "https://en.wikipedia.org/wiki/Soyuz_programme", "description": "The Soyuz programme is a human spaceflight programme initiated by the Soviet Union in the early 1960s. The Soyuz spacecraft was originally part of a Moon landing project intended to put a Soviet cosmonaut on the Moon. It was the third Soviet human spaceflight programme after the Vostok and Voskhod programmes.", "agencies": [ { "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" } }, { "response_mode": "list", "id": 66, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/66/?format=api", "name": "Soviet Space Program", "abbrev": "CCCP", "type": { "id": 1, "name": "Government" } } ], "start_date": "1966-11-28T11:02:00Z", "end_date": null, "mission_patches": [], "type": { "id": 2, "name": "Human Spaceflight" } } ], "orbital_launch_attempt_count": 6987, "location_launch_attempt_count": 1559, "pad_launch_attempt_count": 426, "agency_launch_attempt_count": 338, "orbital_launch_attempt_count_year": 138, "location_launch_attempt_count_year": 6, "pad_launch_attempt_count_year": 6, "agency_launch_attempt_count_year": 9 }, "landing": { "id": 1605, "url": "https://lldev.thespacedevs.com/2.3.0/landings/1605/?format=api", "attempt": true, "success": null, "description": "Soyuz MS-28 will land in Kazakhstan after its approximate 6 month mission on the ISS.", "downrange_distance": null, "landing_location": { "id": 19, "name": "Kazakhstan", "active": true, "abbrev": "KAZ", "description": "Deserts of Kazakhstan in Central Asia", "location": null, "longitude": null, "latitude": null, "image": { "id": 1056, "name": "Soyuz MS landing (MS-04)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/soyuz2520ms-122520landing_image_20190929074125.jpg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305191514.jpeg", "credit": "NASA/Bill Ingalls", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": false, "variants": [] }, "successful_landings": 193, "attempted_landings": 200, "failed_landings": 7, "celestial_body": { "response_mode": "normal", "id": 1, "name": "Earth", "type": { "id": 1, "name": "Planet" }, "diameter": 12742000.0, "mass": 5.972168e+24, "gravity": 9.80655, "length_of_day": "1 00:00:00", "atmosphere": true, "image": { "id": 2040, "name": "Earth (Apollo 17)", "image_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg", "thumbnail_url": "https://thespacedevs-prod.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_thumbnail_20240402194305.jpeg", "credit": "NASA", "license": { "id": 4, "name": "NASA Image and Media Guidelines", "priority": 0, "link": "https://www.nasa.gov/nasa-brand-center/images-and-media/" }, "single_use": true, "variants": [] }, "description": "Earth is the third planet from the Sun and the only astronomical object known to harbor life.", "wiki_url": "https://en.wikipedia.org/wiki/Earth" } }, "type": { "id": 4, "name": "Parachute Landing", "abbrev": "PCL", "description": "Unpowered landing using parachute(s)." } }, "duration": null, "turn_around_time": null, "response_mode": "normal" } ], "spacewalks": [] }
