---
title: "GET /heard-status"
method: GET
path: "/heard-status"
tags: ["heard-status"]
---

# GET /heard-status

`GET /heard-status`

## Request

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

## Query parameters

- `channel_id` string, required
- `date` string, date-time, required
- `direction` 'older' | 'newer', required
- `sequence` number
- `limit` number

## Response `200`

- MessageHeardStatus[]
  - `message_id` string, required
  - `caught_up` 'all' | 'some' | 'none', required: The number of users that listened to the audio or removed the notification
  - `channel_sequence` number, required
  - `last_heard_at` string, date-time, required
  - `notified` boolean, required
  - `heard_ms` number, required

## Other responses

- `400`: date is missing or not a valid date

---

[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)