---
title: "GET /channels/{channelID}/pins"
method: GET
path: "/channels/{channelID}/pins"
tags: ["pin"]
---

# GET /channels/{channelID}/pins

`GET /channels/{channelID}/pins`

チャンネルのピン留め一覧を取得します。

## Response `200`

正常に取得できました。

- Pin[]
  - `pinId` string, uuid — ピンUUID
  - `channelId` string, uuid — チャンネルUUID
  - `userId` string, uuid — ピン留めしたユーザーのUUID
  - `dateTime` string, date-time — ピン留めした日時
  - `message` Message
    - `messageId` string, uuid — メッセージUUID
    - `userId` string, uuid — 投稿者UUID
    - `parentChannelId` string — 投稿先チャンネルUUID
    - `content` string — メッセージ本体
    - `createdAt` string, date-time — メッセージ投稿日時
    - `updatedAt` string, date-time — メッセージ更新日時
    - `pin` boolean — ピン留めされているかどうか
    - `reported` boolean — 自分が通報しているかどうか
    - `stampList` MessageStamp[] — メッセージスタンプ配列
      - `userId` string, uuid — ユーザーUUID
      - `stampId` string, uuid — スタンプUUID
      - `count` integer — 押された個数
      - `createdAt` string, date-time — 最初に押した日時
      - `updatedAt` string, date-time — 最後に押した日時

## Changes

- **2019-07-24** `66a69a1387ed` — 1 info
  - api operation id `getPinnedMessages` was added
- **2019-07-05** `6956f2622a20` — 5 info
  - api operation id `getPinnedMessages` removed and replaced with ``
  - the endpoint scheme security `traqOAuth2` was added to the API
  - endpoint reactivated
  - removed the non-success response with the status `410`
  - …1 more

[Change history](https://skmtc.dev/traptitech/apis/traq-api/changes/channels/:channelID/pins/get.md)

---

[API](https://skmtc.dev/traptitech/apis/traq-api.md) · [All operations](https://skmtc.dev/traptitech/apis/traq-api/llms.txt) · [OpenAPI document](https://skmtc.dev/traptitech/apis/traq-api/revisions/78d32137c921?raw)