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/731/?format=api
{ "id": 731, "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/731/?format=api", "name": "Cai Xuzhe", "status": { "id": 1, "name": "Active" }, "agency": { "response_mode": "list", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } }, "image": { "id": 848, "name": "[AUTO] Cai Xuzhe - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cai_xuzhe_image_20220604085007.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190933.png", "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": "P364DT18H6M29S", "eva_time": "P1DT10H9M", "age": 50, "date_of_birth": "1976-05-01", "date_of_death": null, "nationality": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "bio": "Chinese astronaut from the CNSA Group-2 selection (2010).", "wiki": "https://en.wikipedia.org/wiki/Cai_Xuzhe", "last_flight": "2024-10-29T20:27:34Z", "first_flight": "2022-06-05T02:44:10Z", "social_media_links": [], "flights_count": 2, "landings_count": 2, "spacewalks_count": 5, "flights": [], "landings": [], "spacewalks": [ { "response_mode": "list", "id": 480, "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/480/?format=api", "name": "Shenzhou 19 EVA 1a", "start": "2024-12-17T04:51:00Z", "end": "2024-12-17T13:57:00Z", "duration": "PT9H6M", "location": "Tiangong Space Station", "crew": [ { "id": 5027, "role": { "id": 33, "role": "EV1", "priority": 0 }, "astronaut": { "id": 731, "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/731/?format=api", "name": "Cai Xuzhe", "status": { "id": 1, "name": "Active" }, "agency": { "response_mode": "list", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } }, "image": { "id": 848, "name": "[AUTO] Cai Xuzhe - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cai_xuzhe_image_20220604085007.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190933.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "response_mode": "list", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P364DT18H6M29S", "eva_time": "P1DT10H9M", "age": 50, "date_of_birth": "1976-05-01", "date_of_death": null, "nationality": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "bio": "Chinese astronaut from the CNSA Group-2 selection (2010).", "wiki": "https://en.wikipedia.org/wiki/Cai_Xuzhe", "last_flight": "2024-10-29T20:27:34Z", "first_flight": "2022-06-05T02:44:10Z", "social_media_links": [] } } ] }, { "response_mode": "list", "id": 483, "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/483/?format=api", "name": "Shenzhou 19 EVA 2", "start": "2025-01-20T08:55:00Z", "end": "2025-01-20T17:12:00Z", "duration": "PT8H17M", "location": "Tiangong Space Station", "crew": [ { "id": 5031, "role": { "id": 33, "role": "EV1", "priority": 0 }, "astronaut": { "id": 731, "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/731/?format=api", "name": "Cai Xuzhe", "status": { "id": 1, "name": "Active" }, "agency": { "response_mode": "list", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } }, "image": { "id": 848, "name": "[AUTO] Cai Xuzhe - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cai_xuzhe_image_20220604085007.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190933.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "response_mode": "list", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P364DT18H6M29S", "eva_time": "P1DT10H9M", "age": 50, "date_of_birth": "1976-05-01", "date_of_death": null, "nationality": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "bio": "Chinese astronaut from the CNSA Group-2 selection (2010).", "wiki": "https://en.wikipedia.org/wiki/Cai_Xuzhe", "last_flight": "2024-10-29T20:27:34Z", "first_flight": "2022-06-05T02:44:10Z", "social_media_links": [] } }, { "id": 5032, "role": { "id": 34, "role": "EV2", "priority": 1 }, "astronaut": { "id": 817, "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/817/?format=api", "name": "Song Lingdong", "status": { "id": 1, "name": "Active" }, "agency": { "response_mode": "list", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } }, "image": { "id": 2749, "name": "Song Lingdong official portrait", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/song_lingdong_o_image_20260424072447.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/song_lingdong_o_image_thumbnail_20260424072447.jpeg", "credit": "CNSA", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "response_mode": "list", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P182DT8H40M39S", "eva_time": "PT22H42M", "age": 36, "date_of_birth": "1990-08-01", "date_of_death": null, "nationality": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "bio": "Song Lingdong is a Chinese pilot and astronaut selected as part of the Shenzhou program. He enlisted in the People's Liberation Army (PLA) Air Force in August 2008, and joined the Chinese Communist Party (CCP) in March 2013. He was a Sukhoi Su-35K fighter pilot prior to joining the astronaut corps.", "wiki": null, "last_flight": "2024-10-29T20:27:34Z", "first_flight": "2024-10-29T20:27:34Z", "social_media_links": [] } } ] }, { "response_mode": "list", "id": 485, "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/485/?format=api", "name": "Shenzhou 19 EVA 3", "start": "2025-03-21T05:50:00Z", "end": "2025-03-21T12:50:00Z", "duration": "PT7H", "location": "Tiangong Space Station", "crew": [ { "id": 5075, "role": { "id": 33, "role": "EV1", "priority": 0 }, "astronaut": { "id": 731, "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/731/?format=api", "name": "Cai Xuzhe", "status": { "id": 1, "name": "Active" }, "agency": { "response_mode": "list", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } }, "image": { "id": 848, "name": "[AUTO] Cai Xuzhe - image", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cai_xuzhe_image_20220604085007.png", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305190933.png", "credit": null, "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "response_mode": "list", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P364DT18H6M29S", "eva_time": "P1DT10H9M", "age": 50, "date_of_birth": "1976-05-01", "date_of_death": null, "nationality": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "bio": "Chinese astronaut from the CNSA Group-2 selection (2010).", "wiki": "https://en.wikipedia.org/wiki/Cai_Xuzhe", "last_flight": "2024-10-29T20:27:34Z", "first_flight": "2022-06-05T02:44:10Z", "social_media_links": [] } }, { "id": 5076, "role": { "id": 34, "role": "EV2", "priority": 1 }, "astronaut": { "id": 817, "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/817/?format=api", "name": "Song Lingdong", "status": { "id": 1, "name": "Active" }, "agency": { "response_mode": "list", "id": 17, "url": "https://lldev.thespacedevs.com/2.3.0/agencies/17/?format=api", "name": "China National Space Administration", "abbrev": "CNSA", "type": { "id": 1, "name": "Government" } }, "image": { "id": 2749, "name": "Song Lingdong official portrait", "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/song_lingdong_o_image_20260424072447.jpg", "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/song_lingdong_o_image_thumbnail_20260424072447.jpeg", "credit": "CNSA", "license": { "id": 1, "name": "Unknown", "priority": 9, "link": null }, "single_use": true, "variants": [] }, "response_mode": "list", "type": { "id": 2, "name": "Government" }, "in_space": false, "time_in_space": "P182DT8H40M39S", "eva_time": "PT22H42M", "age": 36, "date_of_birth": "1990-08-01", "date_of_death": null, "nationality": [ { "id": 6, "name": "China", "alpha_2_code": "CN", "alpha_3_code": "CHN", "nationality_name": "Chinese", "nationality_name_composed": "Sino" } ], "bio": "Song Lingdong is a Chinese pilot and astronaut selected as part of the Shenzhou program. He enlisted in the People's Liberation Army (PLA) Air Force in August 2008, and joined the Chinese Communist Party (CCP) in March 2013. He was a Sukhoi Su-35K fighter pilot prior to joining the astronaut corps.", "wiki": null, "last_flight": "2024-10-29T20:27:34Z", "first_flight": "2024-10-29T20:27:34Z", "social_media_links": [] } } ] } ] }
