---
title: "CMCD collector accepting event and response mode playback reports"
method: POST
path: "/metrics/cmcd"
tags: ["Internal"]
---

# CMCD collector accepting event and response mode playback reports

`POST /metrics/cmcd`

Reporting modes are defined by CMCD v2 (CTA-5004-A). CMCD v1 has no reporting modes, v1 request mode data is collected directly from the media requests it decorates. The collector maps any known CMCD keys it receives and does not reject reports based on their version.

## Request body

- union
  - CmcdReport — A CMCD v2 (CTA-5004-A) report keyed by CMCD key names. Any valid CMCD key is accepted; the keys below are the ones consumed.
    - `v` integer — CMCD version of the report
    - `sid` string — Session ID identifying the player session
    - `e` string — Event type that triggered the report (event mode)
    - `ts` number — Timestamp of the report in epoch milliseconds
    - `sta` string — Player state token
    - `mtp` number — Measured throughput in kbps
    - `ltc` number — Live latency in milliseconds
    - `bs` boolean — Buffer starvation occurred
    - `ec` string — Error code accompanying an error event
    - `ttlb` number — Time to last byte in milliseconds (response mode)
    - `sn` number — Report sequence number
  - CmcdReport[]
    - `v` integer — CMCD version of the report
    - `sid` string — Session ID identifying the player session
    - `e` string — Event type that triggered the report (event mode)
    - `ts` number — Timestamp of the report in epoch milliseconds
    - `sta` string — Player state token
    - `mtp` number — Measured throughput in kbps
    - `ltc` number — Live latency in milliseconds
    - `bs` boolean — Buffer starvation occurred
    - `ec` string — Error code accompanying an error event
    - `ttlb` number — Time to last byte in milliseconds (response mode)
    - `sn` number — Report sequence number

## Response `200`

Report accepted

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/owncast/apis/owncast-apis.md) · [All operations](https://skmtc.net/owncast/apis/owncast-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/owncast/owncast-apis/versions/d3510588e78e/schema)