---
title: "Get paged channel membership updates (seen_seq, notified, sort order)"
method: GET
path: "/channel-updates"
tags: ["updates"]
---

# Get paged channel membership updates (seen_seq, notified, sort order)

`GET /channel-updates`

## Request

- Base URL: `https://api.carbonvoice.app`
- URL: `https://api.carbonvoice.app/channel-updates`
- Auth: one of:
  - API key in header `pxtoken`
  - OAuth 2 (implicit, authorization URL `https://api.carbonvoice.app/oauth/authorize`)

The channel_updates previously embedded in GET /updates, paged by a (since, channel_id) keyset cursor: repeat with since=next_since and channel_id=next_channel_id while has_more is true.

## Query parameters

- `since` string, date-time, required
- `channel_id` string
- `limit` number

## Response `200`

- ChannelUpdatesResponse
  - `channel_updates` ChannelUpdate[], required: Fast changing, user specific updates like seen seq
    - `channel_id` string, required: ID of the channel associated with the event
    - `seen_seq` number, required
    - `date` string, date-time, required
    - `channel_sort_order` string, date-time, required
    - `notified` number, required
    - `max_sequence_number` number, required
  - `number_of_channel_updates` number, required
  - `has_more` boolean, required: True when more channel updates exist past this page; request the next page with since=next_since and channel_id=next_channel_id.
  - `next_since` string, date-time, nullable: Keyset cursor date for the next page; pass verbatim as since. Null when the page is empty.
  - `next_channel_id` string, nullable: Keyset cursor channel id for the next page; null when the page is empty.

## Other responses

- `403`

---

[API](https://skmtc.dev/carbonvoice/apis/carbon-voice-api.md) · [All operations](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonvoice/apis/carbon-voice-api/revisions/b91c5c845122?raw)