---
title: "获取指定条目收藏信息"
method: GET
path: "/collection/{subject_id}"
tags: ["收藏"]
---

# 获取指定条目收藏信息

`GET /collection/{subject_id}`

## Path parameters

- `subject_id` integer, required

## Response `200`

条目收藏信息

- object
  - `status` CollectionStatus — 收藏状态 - 1 = wish = 想做 - 2 = collect = 做过 - 3 = do = 在做 - 4 = on_hold = 搁置 - 5 = dropped = 抛弃
    - `id` 1 | 2 | 3 | 4 | 5 — 收藏状态 ID
    - `type` 'wish' | 'collect' | 'do' | 'on_hold' | 'dropped' — 收藏状态类型
    - `name` '想做' | '做过' | '在做' | '搁置' | '抛弃' — 收藏状态名称
  - `rating` integer — 评分
  - `comment` string — 评论
  - `private` 0 | 1 — 收藏隐私
  - `tag` string[] — 标签
  - `ep_status` integer — 完成话数
  - `lasttouch` integer — 上次更新时间
  - `user` User — 用户信息
    - `id` integer — 用户 id
    - `url` string — 用户主页地址
    - `username` string — 用户名
    - `nickname` string — 昵称
    - `avatar` object — 头像地址
      - `large` string
      - `medium` string
      - `small` string
    - `sign` string — 签名
    - `usergroup` UserGroup — unresolved $ref

## Other responses

- `400` — 用户未收藏该条目
- `401` — 未授权

## Changes

- **2022-04-24** `171362386f6a` — 1 breaking, 9 info
  - the `user/usergroup` response's property type changed from `integer` to no type for status `200`
  - removed the `1.00` enum value from the `user/usergroup` response property for the response status `200`
  - removed the `10.00` enum value from the `user/usergroup` response property for the response status `200`
  - removed the `11.00` enum value from the `user/usergroup` response property for the response status `200`
  - …6 more
- **2022-04-20** `b563cadc4629` — 1 info
  - api operation id `getCollectionBySubjectId` was added
- **2021-12-28** `6f49623717d8` — 2 info
  - the endpoint scheme security `OptionalHTTPBearer` was added to the API
  - the endpoint scheme security `bangumi_auth` was removed from the API
- **2018-06-05** `09ae99ced656` — 1 info
  - added the optional property `user/usergroup` to the response with the `200` status
- **2018-02-26** `53c2972105dc` — 11 info
  - the endpoint scheme security `bangumi_auth` was added to the API
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the optional property `comment` to the response with the `200` status
  - …7 more

[Full history](https://skmtc.dev/bangumi/apis/bangumi-api/changes/collection/:subject_id/get.md)

---

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