---
title: "Get Person"
method: GET
path: "/v0/persons/{person_id}"
tags: ["人物"]
---

# Get Person

`GET /v0/persons/{person_id}`

## Request

- The document declares no server URL.
- Auth: none declared

cache with 60s

## Path parameters

- `person_id` integer, required

## Response `200`

Successful Response

- PersonDetail
  - `id` integer, required
  - `name` string, required
  - `type` 1 | 2 | 3, required: `1`, `2`, `3` 表示 `个人`, `公司`, `组合`
  - `career` PersonCareer[], required
  - `images` PersonImages
    - `large` string, required
    - `medium` string, required
    - `small` string, required
    - `grid` string, required
  - `summary` string, required
  - `locked` boolean, required
  - `last_modified` string, date-time, required: currently it's latest user comment time, it will be replaced by wiki modified date in the future
  - `infobox` object[]: server parsed infobox, a map from key to string or tuple null if server infobox is not valid
  - `gender` string: parsed from wiki, maybe null
  - `blood_type` 1 | 2 | 3 | 4: Blood type of a person. A, B, AB, O
  - `birth_year` integer: parsed from wiki, maybe `null`
  - `birth_mon` integer: parsed from wiki, maybe `null`
  - `birth_day` integer: parsed from wiki, maybe `null`
  - `stat` Stat, required
    - `comments` integer, required
    - `collects` integer, required

## Other responses

- `400`: Validation Error
- `404`: Not Found

## Changes

- **2022-11-19** (v0) `bb6bcec42206`: 2 warning, 2 info
  - removed the optional property `detail` from the response with the `400` status
  - removed the optional property `detail` from the response with the `404` status
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `404` status
- **2022-06-21** (v0) `849933a48cb4`: 1 breaking
  - for the `path` request parameter `person_id`, the min was increased from `0.00` to `1.00`
- **2022-05-07** (v0) `588c3a75d5cd`: 4 breaking, 4 warning
  - added `subschema #1, subschema #2` to the `detail` response property `oneOf` list for the response status `400`
  - added `subschema #1, subschema #2` to the `detail` response property `oneOf` list for the response status `404`
  - the `detail` response's property type changed from `object` to no type for status `400`
  - the `detail` response's property type changed from `object` to no type for status `404`
  - …4 more
- **2022-04-23** (v0) `c74b08b9afd8`: 2 breaking
  - the response property `detail` became optional for the status `400`
  - the response property `detail` became optional for the status `404`
- …earlier changes not shown

[Operation history](https://skmtc.dev/bangumi/apis/bangumi-open-api/changes/v0/persons/:person_id/get.md)

---

[API](https://skmtc.dev/bangumi/apis/bangumi-open-api.md) - [All operations](https://skmtc.dev/bangumi/apis/bangumi-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bangumi/apis/bangumi-open-api/revisions/6aafdbda7895?raw)