---
title: "GET /channels/{channelID}/events"
method: GET
path: "/channels/{channelID}/events"
tags: ["channel"]
---

# GET /channels/{channelID}/events

`GET /channels/{channelID}/events`

チャンネルイベントのリストを取得します。

## Query parameters

- `limit` integer
- `offset` integer
- `since` string, date-time
- `until` string, date-time
- `inclusive` boolean
- `order` 'asc' | 'desc'

## Response `200`

正常に取得ができました。イベントの配列を返します。

- ChannelEvent[]
  - `type` 'TopicChanged' | 'SubscribersChanged' | 'PinAdded' | 'PinRemoved' | 'NameChanged' | 'ParentChanged' | 'VisibilityChanged' | 'ForcedNotificationChanged' | 'ChildCreated' — イベントタイプ
  - `detail` union — イベント詳細
    - TopicChangedEvent — TopicChanged
      - `userId` string, uuid — 変更者UUID
      - `before` string — 変更前トピック
      - `after` string — 変更後トピック
    - SubscribersChangedEvent — SubscribersChanged
      - `userId` string, uuid — 変更者UUID
      - `on` string[] — UUIDの配列
      - `off` string[] — UUIDの配列
    - PinAddedEvent — PinAdded
      - `userId` string, uuid — 変更者UUID
      - `messageId` string, uuid — メッセージUUID
    - PinRemovedEvent — PinRemoved
      - `userId` string, uuid — 変更者UUID
      - `messageId` string, uuid — メッセージUUID
    - NameChangedEvent — NameChanged
      - `userId` string, uuid — 変更者UUID
      - `before` string — 変更前名前
      - `after` string — 変更後名前
    - ParentChangedEvent — ParentChanged
      - `userId` string, uuid — 変更者UUID
      - `before` string, uuid — 変更前親チャンネルUUID
      - `after` string, uuid — 変更後親チャンネルUUID
    - VisibilityChangedEvent — VisibilityChanged
      - `userId` string, uuid — 作成者UUID
      - `visibility` boolean — 可視状態
    - ForcedNotificationChangedEvent — ForcedNotificationChanged
      - `userId` string, uuid — 作成者UUID
      - `force` boolean — 強制状態
    - ChildCreatedEvent — ChildCreated
      - `userId` string, uuid — 作成者UUID
      - `channelId` string, uuid — チャンネルUUID
  - `date_time` string, date-time — イベント発生日

## Other responses

- `400` — 変更に失敗しました 不正なリクエストです
- `404` — +| 取得に失敗しました。 指定したチャンネルは存在しません。

## Changes

- **2019-08-26** `4de5b90479f5` — 1 breaking
  - for the `query` request parameter `until`, default value `9999-12-31T23:59:99.999999Z` was removed
- **2019-07-24** `66a69a1387ed` — 1 info
  - api operation id `getChannelEvents` was added
- **2019-07-08** `1084a694de9b` — 1 info
  - endpoint added
- **2019-07-05** `6956f2622a20` — 1 info
  - api path removed with deprecation

[Change history](https://skmtc.dev/traptitech/apis/traq-api/changes/channels/:channelID/events/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/535e1f620613?raw)