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 - lldev.thespacedevs.com/docs

GET /2.3.0/astronauts/916/?format=api
HTTP 200 OK
Allow: GET
Content-Type: application/json
Vary: Accept

{
  "id": 916,
  "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/916/?format=api",
  "name": "Zhang Zhiyuan",
  "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": 2765,
    "name": "Zhang Zhiyuan official portrait",
    "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/zhang_zhiyuan_o_image_20260524125922.png",
    "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/zhang_zhiyuan_o_image_thumbnail_20260524125922.png",
    "credit": "CNSA",
    "license": {
      "id": 1,
      "name": "Unknown",
      "priority": 9,
      "link": null
    },
    "single_use": true,
    "variants": []
  },
  "response_mode": "detailed",
  "type": {
    "id": 2,
    "name": "Government"
  },
  "in_space": true,
  "time_in_space": "P160DT10H22M5S",
  "eva_time": "PT5H29M",
  "age": 40,
  "date_of_birth": "1986-06-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": "Zhang Zhiyuan is a Chinese astronaut selected as part of the Shenzhou program. He enlisted in the People's Liberation Army (PLA) Air Force in September 2006, and joined the Chinese Communist Party (CCP) in March 2011. He was a pilot at the People's Liberation Army Air Force (PLAAF) prior to joining the astronaut corps.",
  "wiki": null,
  "last_flight": "2026-05-24T15:08:36Z",
  "first_flight": "2026-05-24T15:08:36Z",
  "social_media_links": [],
  "flights_count": 1,
  "landings_count": 0,
  "spacewalks_count": 1,
  "flights": [
    {
      "id": "a0e0f590-1cb4-4b6b-845c-0087633af132",
      "url": "https://lldev.thespacedevs.com/2.3.0/launches/a0e0f590-1cb4-4b6b-845c-0087633af132/?format=api",
      "name": "Long March 2F/G | Shenzhou 23",
      "response_mode": "normal",
      "slug": "long-march-2fg-shenzhou-23",
      "launch_designator": "2026-113",
      "status": {
        "id": 3,
        "name": "Launch Successful",
        "abbrev": "Success",
        "description": "The launch vehicle successfully inserted its payload(s) into the target orbit(s)."
      },
      "last_updated": "2026-11-01T01:39:54Z",
      "net": "2026-05-24T15:08:36Z",
      "net_precision": {
        "id": 0,
        "name": "Second",
        "abbrev": "SEC",
        "description": "The T-0 is accurate to the second."
      },
      "window_end": "2026-05-24T15:38:00Z",
      "window_start": "2026-05-24T14:58:00Z",
      "image": {
        "id": 2580,
        "name": "Shenzhou 22 launch",
        "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_22_lau_image_20251129175823.jpg",
        "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_22_lau_image_thumbnail_20251129175823.jpeg",
        "credit": "Xinhua",
        "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": 88,
        "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
        "name": "China Aerospace Science and Technology Corporation",
        "abbrev": "CASC",
        "type": {
          "id": 1,
          "name": "Government"
        }
      },
      "rocket": {
        "id": 8900,
        "configuration": {
          "response_mode": "list",
          "id": 84,
          "url": "https://lldev.thespacedevs.com/2.3.0/launcher_configurations/84/?format=api",
          "name": "Long March 2F/G",
          "families": [
            {
              "response_mode": "list",
              "id": 106,
              "name": "Long March"
            },
            {
              "response_mode": "list",
              "id": 109,
              "name": "Long March 2"
            }
          ],
          "full_name": "Long March 2F/G",
          "variant": "F/G"
        }
      },
      "mission": {
        "id": 7491,
        "name": "Shenzhou 23",
        "type": "Human Exploration",
        "description": "Shenzhou 23 will be the 23rd flight of the Shenzhou program.",
        "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": 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"
            },
            "featured": true,
            "country": [
              {
                "id": 6,
                "name": "China",
                "alpha_2_code": "CN",
                "alpha_3_code": "CHN",
                "nationality_name": "Chinese",
                "nationality_name_composed": "Sino"
              }
            ],
            "description": "The China National Space Administration (CNSA) is the national space agency of the People's Republic of China. It is responsible for the national space program and for planning and development of space activities. CNSA and China Aerospace Corporation (CASC) assumed the authority over space development efforts previously held by the Ministry of Aerospace Industry. The CNSA has many launch sites around China with their orbital sites located in Jiuquan, Xichang, Taiyuan and Wenchang.",
            "administrator": "Administrator: Tang Dengjie",
            "founding_year": 1993,
            "launchers": "",
            "spacecraft": "Shenzhou",
            "parent": null,
            "image": {
              "id": 9,
              "name": "[AUTO] China National Space Administration - image",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_image_20190207032431.jpeg",
              "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184601.jpeg",
              "credit": null,
              "license": {
                "id": 1,
                "name": "Unknown",
                "priority": 9,
                "link": null
              },
              "single_use": true,
              "variants": []
            },
            "logo": {
              "id": 125,
              "name": "[AUTO] China National Space Administration - logo",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/china2520national2520space2520administration_logo_20190207032431.png",
              "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305184936.png",
              "credit": null,
              "license": {
                "id": 1,
                "name": "Unknown",
                "priority": 9,
                "link": null
              },
              "single_use": true,
              "variants": []
            },
            "social_logo": {
              "id": 51,
              "name": "CNSA social logo",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnsa_social_log_image_20260504180043.jpg",
              "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/cnsa_social_log_image_thumbnail_20260504180043.jpeg",
              "credit": "CNSA",
              "license": {
                "id": 1,
                "name": "Unknown",
                "priority": 9,
                "link": null
              },
              "single_use": true,
              "variants": []
            },
            "total_launch_count": 2,
            "consecutive_successful_launches": 2,
            "successful_launches": 2,
            "failed_launches": 0,
            "pending_launches": 0,
            "consecutive_successful_landings": 0,
            "successful_landings": 0,
            "failed_landings": 0,
            "attempted_landings": 0,
            "successful_landings_spacecraft": 21,
            "failed_landings_spacecraft": 1,
            "attempted_landings_spacecraft": 22,
            "successful_landings_payload": 2,
            "failed_landings_payload": 0,
            "attempted_landings_payload": 2,
            "info_url": "https://www.cnsa.gov.cn/",
            "wiki_url": "https://en.wikipedia.org/wiki/China_National_Space_Administration",
            "social_media_links": []
          }
        ],
        "info_urls": [],
        "vid_urls": []
      },
      "pad": {
        "id": 37,
        "url": "https://lldev.thespacedevs.com/2.3.0/pads/37/?format=api",
        "active": true,
        "agencies": [],
        "name": "Launch Area 91 (SLS-1 / 921)",
        "image": {
          "id": 1363,
          "name": "Long March 2F/G from LA-4 (Shenzhou 17)",
          "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20231231163528.jpeg",
          "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192527.jpeg",
          "credit": "我们的太空",
          "license": {
            "id": 1,
            "name": "Unknown",
            "priority": 9,
            "link": null
          },
          "single_use": false,
          "variants": []
        },
        "description": "",
        "info_url": null,
        "wiki_url": "https://en.wikipedia.org/wiki/Jiuquan_Launch_Area_4",
        "map_url": "https://www.google.com/maps?q=40.957893,100.290944",
        "latitude": 40.957893,
        "longitude": 100.290944,
        "country": {
          "id": 6,
          "name": "China",
          "alpha_2_code": "CN",
          "alpha_3_code": "CHN",
          "nationality_name": "Chinese",
          "nationality_name_composed": "Sino"
        },
        "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/pad_37_20200803143603.jpg",
        "total_launch_count": 29,
        "orbital_launch_attempt_count": 29,
        "fastest_turnaround": "P24DT12H26M59S",
        "location": {
          "response_mode": "normal",
          "id": 17,
          "url": "https://lldev.thespacedevs.com/2.3.0/locations/17/?format=api",
          "name": "Jiuquan Satellite Launch Center, People's Republic of China",
          "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-dev.nyc3.digitaloceanspaces.com/media/images/earth_2528apol_image_20240402194304.jpeg",
              "thumbnail_url": "https://thespacedevs-dev.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": 7651,
            "successful_launches": 7094,
            "failed_launches": 557,
            "total_attempted_landings": 1384,
            "successful_landings": 1335,
            "failed_landings": 49
          },
          "active": true,
          "country": {
            "id": 6,
            "name": "China",
            "alpha_2_code": "CN",
            "alpha_3_code": "CHN",
            "nationality_name": "Chinese",
            "nationality_name_composed": "Sino"
          },
          "description": "Jiuquan Satellite Launch Center is a Chinese spaceport located between the Ejin, Alxa, Inner Mongolia and Hangtian Town, Jinta County, Jiuquan, Gansu Province. It is part of the Dongfeng Aerospace City (Base 10).",
          "image": {
            "id": 1374,
            "name": "Long March 2F/G liftoff (Shenzhou 16)",
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/long2520march_image_20240101085213.jpeg",
            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305192548.jpeg",
            "credit": "CMS",
            "license": {
              "id": 1,
              "name": "Unknown",
              "priority": 9,
              "link": null
            },
            "single_use": false,
            "variants": []
          },
          "map_image": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/map_images/location_17_20200803142429.jpg",
          "longitude": 100.291111,
          "latitude": 40.958056,
          "timezone_name": "Asia/Shanghai",
          "total_launch_count": 300,
          "total_landing_count": 3
        }
      },
      "webcast_live": false,
      "program": [
        {
          "response_mode": "normal",
          "id": 7,
          "url": "https://lldev.thespacedevs.com/2.3.0/programs/7/?format=api",
          "name": "Shenzhou",
          "image": {
            "id": 1888,
            "name": "[AUTO] Shenzhou - image",
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/shenzhou_program_20200820204745.PNG",
            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194040.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/Shenzhou_program",
          "description": "The Shenzhou program is a crewed spaceflight initiative by China. The program put the first Chinese citizen, Yang Liwei, into orbit on 15 October 2003.",
          "agencies": [
            {
              "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"
              }
            }
          ],
          "start_date": "1993-01-01T00:00:00Z",
          "end_date": null,
          "mission_patches": [],
          "type": {
            "id": 2,
            "name": "Human Spaceflight"
          }
        },
        {
          "response_mode": "normal",
          "id": 19,
          "url": "https://lldev.thespacedevs.com/2.3.0/programs/19/?format=api",
          "name": "Tiangong space station",
          "image": {
            "id": 1893,
            "name": "[AUTO] Tiangong space station - image",
            "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/chinese2520spa_program_20210608105528.png",
            "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305194050.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/Tiangong_space_station",
          "description": "The Tiangong space station is a space station placed in Low Earth orbit between 340 and 450 km above the surface.",
          "agencies": [
            {
              "response_mode": "list",
              "id": 88,
              "url": "https://lldev.thespacedevs.com/2.3.0/agencies/88/?format=api",
              "name": "China Aerospace Science and Technology Corporation",
              "abbrev": "CASC",
              "type": {
                "id": 1,
                "name": "Government"
              }
            }
          ],
          "start_date": "2021-04-29T03:23:00Z",
          "end_date": null,
          "mission_patches": [],
          "type": {
            "id": 2,
            "name": "Human Spaceflight"
          }
        }
      ],
      "orbital_launch_attempt_count": 7291,
      "location_launch_attempt_count": 286,
      "pad_launch_attempt_count": 29,
      "agency_launch_attempt_count": 591,
      "orbital_launch_attempt_count_year": 118,
      "location_launch_attempt_count_year": 13,
      "pad_launch_attempt_count_year": 2,
      "agency_launch_attempt_count_year": 21
    }
  ],
  "landings": [],
  "spacewalks": [
    {
      "response_mode": "list",
      "id": 500,
      "url": "https://lldev.thespacedevs.com/2.3.0/spacewalks/500/?format=api",
      "name": "Shenzhou 23 EVA 1",
      "start": "2026-08-28T00:30:00Z",
      "end": "2026-08-28T05:59:00Z",
      "duration": "PT5H29M",
      "location": "Tiangong Space Station",
      "crew": [
        {
          "id": 5299,
          "role": {
            "id": 33,
            "role": "EV1",
            "priority": 0
          },
          "astronaut": {
            "id": 764,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/764/?format=api",
            "name": "Zhu Yangzhu",
            "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": 230,
              "name": "Zhu Yangzhu official portrait",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/yangzhu_zhu_image_20230530052559.jpeg",
              "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/255bauto255d__image_thumbnail_20240305185258.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": true,
            "time_in_space": "P314DT9H1M30S",
            "eva_time": "PT13H24M",
            "age": 40,
            "date_of_birth": "1986-09-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": "Zhu Yangzhu is a Chinese pilot and astronaut selected as part of the Shenzhou program. He enlisted in the People's Liberation Army (PLA) in September 2005, and joined the Chinese Communist Party (CCP) in December 2006.",
            "wiki": "https://en.wikipedia.org/wiki/Zhu_Yangzhu",
            "last_flight": "2026-05-24T15:08:36Z",
            "first_flight": "2023-05-30T01:31:10Z",
            "social_media_links": []
          }
        },
        {
          "id": 5300,
          "role": {
            "id": 34,
            "role": "EV2",
            "priority": 1
          },
          "astronaut": {
            "id": 916,
            "url": "https://lldev.thespacedevs.com/2.3.0/astronauts/916/?format=api",
            "name": "Zhang Zhiyuan",
            "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": 2765,
              "name": "Zhang Zhiyuan official portrait",
              "image_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/zhang_zhiyuan_o_image_20260524125922.png",
              "thumbnail_url": "https://thespacedevs-dev.nyc3.digitaloceanspaces.com/media/images/zhang_zhiyuan_o_image_thumbnail_20260524125922.png",
              "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": true,
            "time_in_space": "P160DT10H22M5S",
            "eva_time": "PT5H29M",
            "age": 40,
            "date_of_birth": "1986-06-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": "Zhang Zhiyuan is a Chinese astronaut selected as part of the Shenzhou program. He enlisted in the People's Liberation Army (PLA) Air Force in September 2006, and joined the Chinese Communist Party (CCP) in March 2011. He was a pilot at the People's Liberation Army Air Force (PLAAF) prior to joining the astronaut corps.",
            "wiki": null,
            "last_flight": "2026-05-24T15:08:36Z",
            "first_flight": "2026-05-24T15:08:36Z",
            "social_media_links": []
          }
        }
      ]
    }
  ]
}