---
title: "获取用户人物收藏列表"
method: GET
path: "/v0/users/{username}/collections/-/persons"
tags: ["收藏"]
---

# 获取用户人物收藏列表

`GET /v0/users/{username}/collections/-/persons`

## Request

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

## Path parameters

- `username` string, required

## Response `200`

Successful Response

- PagedUserPersonCollection
  - `total` integer
  - `limit` integer
  - `offset` integer
  - `data` UserPersonCollection[]
    - `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
    - `created_at` string, date-time, required

## Other responses

- `404`: 用户不存在

## Changes

- **2024-10-01** (v0) `25167996e069`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bangumi/apis/bangumi-open-api/changes/v0/users/:username/collections/-/persons/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)