HTTP API
The SDKs call a small HTTP API. This page documents that contract, so you can resolve streams from your own code. Most integrations don't need it: the Bring your own player mode keeps your player and still uses the SDK for resolution, license headers and refresh. Read Before you go SDK-less first.
Overview
| Method | Path | Returns | Use it to |
|---|---|---|---|
GET | /v1/catalog | Catalog | List tournaments and matches |
GET | /v1/matches/{matchUrn} | Match | Read one match, poll its status |
GET | /v1/tournaments/{tournamentUrn} | Tournament | Read one tournament with its matches |
GET | /v1/playback/{matchUrn} | Playback | Get the manifest URL and DRM URLs |
POST | drm.widevine.licenseUrl, drm.fairplay.licenseUrl | License bytes | Get a DRM license |
GET | /v1/events/{matchUrn} | StateEvent stream | Follow one match's live state |
GET | /v1/events | StateEvent stream | Follow every match in your catalog |
A typical player makes three calls:
GET /v1/catalogto show the matches.GET /v1/playback/{matchUrn}when the viewer picks one.POSTto the license URL from step 2, made by the player's DRM module.
Base URLs
| Environment | API | Live-state events (SSE) |
|---|---|---|
| Integration | https://feed-dev.oddin-video.gg | https://events.feed-dev.oddin-video.gg |
| Production | https://feed.oddin-video.gg | https://events.feed.oddin-video.gg |
Test keys (pk_test_…) work against integration, and production keys (pk_live_…) against production. Every other host you call comes from a response: the manifest URL, the DRM license URL and the analytics endpoint. Don't hard-code those.
Conventions
| Topic | Rule |
|---|---|
| Format | JSON, UTF-8. Field names are camelCase |
| Timestamps | Strings in RFC 3339, always UTC, to the second: "2026-05-07T18:00:00Z" |
| URNs | Strings. Matches are od:match:<id>, tournaments od:tournament:<id>, teams od:competitor:<id> |
| Optional field | Left out of the object when it has no value. Never sent as null |
| Arrays | Always an array when present. Can be empty |
| New fields | We add fields without notice. Ignore fields you don't know |
| Enum values | We can add values. Handle a value you don't know as described for each field |
In the type tables below, a field marked optional can be absent. Every other field is in every object of that type.
Authentication
Every /v1/ request carries the publishable api-key in a header:
| Header | Required | Value |
|---|---|---|
x-api-key | Yes | Your publishable key, pk_test_… or pk_live_… |
Origin | Yes | Set by the browser. It must be on the key's allow-list |
Call the API from the viewer's browser, on an origin that is on your key's allow-list. A request with no Origin (curl, Postman, a backend proxy) is rejected. The license URL in a playback response is also bound to the key that fetched it. See Get your origins allow-listed. This page covers browsers. Native apps use the iOS and Android SDKs, which authenticate in a different way.
const res = await fetch('https://feed-dev.oddin-video.gg/v1/catalog', {
headers: { 'x-api-key': 'pk_test_…' },
});| Status | error.code | Meaning |
|---|---|---|
401 | UNAUTHORIZED | The key is unknown, revoked, suspended, or used on the wrong environment |
403 | FORBIDDEN | The key is valid, but the request's origin is not on its allow-list |
429 | RATE_LIMITED | Too many requests from your key or address. Wait Retry-After seconds |
503 | UPSTREAM_UNAVAILABLE | The auth service is unreachable. Retry after Retry-After seconds |
Every response carries an X-Request-ID header. Include it when you contact havik-support@oddin.gg. Error bodies are an ApiError.
GET /v1/catalog
Returns the tournaments and matches your key is entitled to, as a Catalog. The catalog carries metadata only. To play a match, call /v1/playback/{matchUrn}.
Request
GET /v1/catalog?sport=cs2,dota2&status=live,upcoming HTTP/1.1
Host: feed-dev.oddin-video.gg
x-api-key: pk_test_…
If-None-Match: W/"9f2c1a7e"| Query param | Type | Values | Effect |
|---|---|---|---|
sport | comma-separated strings | Any Tournament.sport value | Only tournaments of those sports |
status | comma-separated strings | Any MatchStatus value | Only matches with one of those statuses |
limit | integer | 1 to 1000 | Only the first N tournaments, by from |
All parameters are optional. Filters combine with AND across parameters and OR within one parameter. The server ignores unknown values and unknown parameters.
Response 200: a Catalog.
{
"tournaments": [
{
"name": "IEM Katowice 2026",
"urn": "od:tournament:42",
"description": "Intel Extreme Masters, Katowice",
"liquipediaUrl": "https://liquipedia.net/counterstrike/IEM/2026/Katowice",
"sport": "cs2",
"from": "2026-02-01T10:00:00Z",
"to": "2026-02-14T22:00:00Z",
"isOffline": true,
"matches": [
{
"matchUrn": "od:match:1234",
"matchName": "Team A vs Team B",
"datePlannedStart": "2026-02-08T18:00:00Z",
"status": "live",
"teams": [
{
"urn": "od:competitor:26406",
"name": "Team A",
"isHome": true,
"logoUrl": "https://cdn.oddin.gg/assets/teams/icons/team_a.png"
},
{ "urn": "od:competitor:20836", "name": "Team B", "isHome": false }
]
}
]
}
]
}| Response header | Meaning |
|---|---|
ETag | A version of this body. Send it back as If-None-Match to get 304 when unchanged |
Cache-Control | public, max-age=10, stale-while-revalidate=30. max-age=0, must-revalidate while stale. Poll no faster than that |
X-Catalog-Stale | true when the server answered from its cache because its source is degraded |
X-Catalog-Truncated | true when limit cut the list |
Response 304 Not Modified: sent when your If-None-Match equals the current ETag. It has no body: keep using the catalog you already hold. The ETag and Cache-Control headers are still set.
| Status | error.code | Meaning |
|---|---|---|
200 | A Catalog | |
304 | Unchanged since your If-None-Match. No body |
Errors are the auth errors in Authentication.
Tournaments are sorted by from, and matches by datePlannedStart. Tournaments with no matches left after filtering are omitted. There is no push channel for the catalog, so poll it. For an auto-updating lobby, use the catalog-wide event stream.
GET /v1/matches/{matchUrn}
Returns one Match. Use it for deep links, and to poll one match's status: the edge caches it, unlike /v1/playback.
Request
GET /v1/matches/od:match:1234 HTTP/1.1
Host: feed-dev.oddin-video.gg
x-api-key: pk_test_…
If-None-Match: W/"4b7e90d2"Response 200: a Match.
{
"matchUrn": "od:match:1234",
"matchName": "Team A vs Team B",
"datePlannedStart": "2026-02-08T18:00:00Z",
"status": "upcoming",
"teams": [
{ "urn": "od:competitor:26406", "name": "Team A", "isHome": true },
{ "urn": "od:competitor:20836", "name": "Team B", "isHome": false }
]
}| Response header | Meaning |
|---|---|
ETag | A version of this body. Send it back as If-None-Match to get 304 when unchanged |
Cache-Control | public, max-age=10, stale-while-revalidate=30. Poll no faster than that |
| Status | error.code | Meaning |
|---|---|---|
200 | A Match | |
304 | Unchanged since your If-None-Match. No body | |
400 | INVALID_URN | The URN is malformed |
404 | NOT_FOUND | The match is not in your catalog, or has left it (after its end) |
The auth errors in Authentication also apply.
GET /v1/tournaments/{tournamentUrn}
Returns one Tournament with its matches.
Request
GET /v1/tournaments/od:tournament:42 HTTP/1.1
Host: feed-dev.oddin-video.gg
x-api-key: pk_test_…Response 200: a Tournament, in the same shape as one entry of Catalog.tournaments. See the catalog example.
| Response header | Meaning |
|---|---|
Cache-Control | public, max-age=10, stale-while-revalidate=30. Poll no faster than that |
This endpoint sends no ETag and never answers 304.
| Status | error.code | Meaning |
|---|---|---|
200 | A Tournament | |
400 | INVALID_URN | The URN is malformed |
404 | NOT_FOUND | The tournament is not in your catalog |
The auth errors in Authentication also apply.
GET /v1/playback/{matchUrn}
Returns the Playback credential for one match: the manifest URL and the DRM license URLs. This is the entitlement gate. A match outside your key's tournaments returns the same 404 as an unknown match.
Request
GET /v1/playback/od:match:1234 HTTP/1.1
Host: feed-dev.oddin-video.gg
x-api-key: pk_test_…Response 200: a Playback.
{
"matchUrn": "od:match:1234",
"protocol": "hls",
"mediaType": "live",
"drmEnabled": true,
"manifestUrl": "https://<cdn-host>/<path>/main.m3u8",
"drm": {
"widevine": {
"licenseUrl": "https://<drm-host>/v1/drm/license/widevine?<signature>"
},
"fairplay": {
"licenseUrl": "https://<drm-host>/v1/drm/license/fairplay?<signature>",
"certificateUrl": "https://<drm-host>/v1/drm/certificate/fairplay"
}
},
"expiresAt": "2026-05-07T22:00:07Z",
"serverTime": "2026-05-07T10:00:00Z",
"analytics": {
"sid": "3f1b9c52-6a0e-4d7b-9e43-2c8d1f0a7b61",
"endpoint": "https://<beacons-host>"
}
}The <…> parts vary by viewer and by request. Use every URL exactly as you receive it.
Other responses
| Status | error.code | Meaning | What to do |
|---|---|---|---|
400 | INVALID_URN | The URN is malformed | Fix the URN |
404 | NOT_FOUND | Unknown match, or not in your entitlement | Stop |
410 | GONE | The tournament has ended and nothing is serving the match | Stop |
425 | TOO_EARLY | Not playable yet: before kickoff, or packaging in progress | Retry after Retry-After seconds |
503 | UNAVAILABLE | No stream right now: it dropped, or there is none | Retry with backoff, or wait for a live event |
A 425 body is a TooEarlyError:
{
"error": { "code": "TOO_EARLY", "message": "match has not started; retry in 60s" },
"liveStartsAt": "2026-05-07T18:00:00Z"
}Retry-After follows the time to kickoff: the exact delta inside 30 seconds, then a tenth of the delta, capped at 5 minutes. Add jitter to your retries, because every viewer of a match waits for the same kickoff.
Caching. Every playback response is sent with Cache-Control: private, no-store. It is per viewer: the hosts in it follow the viewer's region. Call it once per playback start, and again to refresh the license URL.
License requests
The player's DRM module POSTs the CDM's license challenge to drm.widevine.licenseUrl or drm.fairplay.licenseUrl. FairPlay players first GET the certificate from drm.fairplay.certificateUrl, with the x-api-key header. Send no api-key on manifest and segment requests: those go to a public CDN.
Request
POST /v1/drm/license/widevine?<signature> HTTP/1.1
Host: <drm-host>
x-api-key: pk_test_…
X-Device-Id: 8d4f2b1e-0c7a-4e59-b3d6-71a2e9f05c34
X-Match-Urn: od:match:1234
Content-Type: application/octet-stream
<challenge bytes from the CDM>| Header | Required | Value |
|---|---|---|
x-api-key | Yes | The same key that fetched the playback response |
X-Device-Id | Yes | A stable id per browser or device. Up to 256 characters A-Za-z0-9-_.@: |
X-Match-Urn | Yes | The match URN |
Content-Type | Yes | application/octet-stream |
X-User-Id | No | Your own viewer id, same character rules as X-Device-Id |
The body is the raw challenge bytes from the CDM, at most 16 KiB. A 200 response body is the license bytes: hand them to the CDM unchanged.
Three rules cause most license failures:
- POST the URL unchanged. Don't rewrite, re-encode or reorder its query string. The query string is the signature.
- Use the same api-key for the playback request and the license request. The signature is bound to it.
- Get your origin on the DRM allow-list too. A missing origin fails in the CORS preflight, and the viewer sees black video with no error.
Errors from the license and certificate endpoints are a DrmError. This is the complete list:
| Status | error | Meaning | What to do |
|---|---|---|---|
400 | missing_device_id | No X-Device-Id header | Fix the request |
400 | invalid_device_id | X-Device-Id is too long or has a character outside A-Za-z0-9-_.@: | Fix the request |
400 | invalid_user_id | Same rules, for X-User-Id | Fix the request |
400 | missing_match_urn | The match could not be read from the request | Fix the request |
400 | invalid_match_urn | The match URN is malformed | Fix the request |
400 | invalid_drm_system | The path names a DRM system other than widevine or fairplay | Use the URL unchanged |
400 | invalid_request_body | The body could not be read | Fix the request |
400 | empty_challenge | The body is empty | Send the CDM's challenge bytes |
401 | (no body) | The api-key is unknown, revoked or on the wrong environment | Check the key |
403 | origin_not_allowed | Your page's origin is not on the key's allow-list | Get the origin allow-listed |
403 | forbidden | The license URL expired or was changed, or a different api-key was used | Resolve again, then retry |
403 | entitlement_denied | Your key is not entitled to this match | Stop |
403 | license_refused | The license provider refused this request | Stop. Retrying does not help |
403 | cdm_revoked | The provider says this device's DRM module is revoked | Stop. Tell the viewer |
404 | not_found | No such path | Use the URL unchanged |
405 | method_not_allowed | Wrong HTTP method | POST licenses, GET the certificate |
413 | request_too_large | The challenge is larger than 16 KiB | Fix the request |
429 | rate_limit_exceeded | Too many license requests from this address | Back off, then retry |
500 | internal_error | An error inside the DRM service | Retry once |
502 | drm_provider_error | The upstream license provider failed | Retry once |
503 | entitlement_unavailable | The entitlement check could not run | Retry with backoff |
License URL lifetime
There are two lifetimes, and they are not the same:
| What | Lifetime | What happens when it runs out |
|---|---|---|
| The signed license URL | 10 minutes | A new license request with that URL gets 403 |
| The license in the CDM | 4 hours by default | Playback stops with a DRM error. A new license is needed |
The license lifetime is set per key, so yours can differ from the default. Ask havik-support@oddin.gg for the value on your key, and don't build a fixed 4-hour timer into your player.
The license URL only matters when the player makes a license request. That happens at start, and again whenever your player rebuilds its DRM session, for example after a recovery or a reload. A player that holds an old URL then fails with 403.
Re-resolve /v1/playback/{matchUrn} before the URL expires, and give the player the new license URL for its next request. The SDK does this every 8 minutes. Don't reload the manifest or the player when you refresh: only the license URL changes. A refresh can't extend a license that the CDM already holds.
GET /v1/events/{matchUrn}
A Server-Sent Events stream of StateEvent objects for one match. Use it to start playback the moment a match goes live, and to stop at the end without polling. It is served on the events host from Base URLs, with the same x-api-key and entitlement rules.
The browser's EventSource can't send an x-api-key header. Use a fetch-based SSE client, such as @microsoft/fetch-event-source.
event: state
data: {"matchUrn":"od:match:1234","state":"live","serverTime":"2026-06-25T12:00:00Z"}
: ping
event: state
data: {"matchUrn":"od:match:1234","state":"ended","reason":"interrupted","serverTime":"2026-06-25T13:41:09Z"}Request
GET /v1/events/od:match:1234 HTTP/1.1
Host: events.feed-dev.oddin-video.gg
x-api-key: pk_test_…
Accept: text/event-streamResponse 200: a stream that stays open. The first line is retry: 3000, the reconnect delay in milliseconds.
| Response header | Value |
|---|---|
Content-Type | text/event-stream; charset=utf-8 |
Cache-Control | no-store |
| Status | error.code | Meaning | What to do |
|---|---|---|---|
200 | The stream is open | Read events | |
400 | INVALID_URN | The URN is malformed | Fix the URN |
404 | NOT_FOUND | Unknown match, or not in your entitlement | Stop |
503 | TOO_MANY_CONNECTIONS | Your address has too many streams open. Sent with Retry-After: 10 | Close unused streams, then retry |
Error responses have an ApiError body. The auth errors in Authentication also apply.
Each data: line is one StateEvent as JSON. On connect, the server sends the current state, then each change. Comment lines (: ping) keep the connection open, about every 20 seconds: ignore them. The server closes each connection after about 30 minutes. Reconnect, and you get the current state again.
state | Meaning | Matching /v1/playback | What to do |
|---|---|---|---|
upcoming | Before kickoff | 425 | Wait |
pending | Kickoff has passed and packaging is in progress | 425 | Wait |
live | Playable | 200 | Fetch /v1/playback, then play |
ended | The stream stopped. See reason | 503 | Stop loading, keep the connection open |
gone | Nothing is coming: the tournament ended, or no stream | 410 or 503 | Stop, close the connection |
An ended event with reason: "interrupted" means a stream that was playing has dropped. Show "reconnecting", not "this stream has ended". If the stream comes back, it often comes back under a new manifest URL, so fetch /v1/playback again on the next live. Treat any state you don't recognize as "wait".
At the end of a match, the HLS playlist does not get an #EXT-X-ENDLIST tag. It stops changing. Use this event stream as the end signal. As a fallback, treat a playlist that has not advanced for about 12 seconds as ended.
GET /v1/events
The same stream for every match in your catalog, for an auto-updating lobby. On connect, it sends one StateEvent for each match that is not gone, then each change. Use matchUrn to tell the matches apart.
The request, headers and errors are the same as for /v1/events/{matchUrn}, without the 400 and 404. Matches outside your entitlement are left out of the stream.
Data types
Each type is shown as a TypeScript definition, then field by field. A ? in the definition marks an optional field.
Catalog
The body of GET /v1/catalog.
interface Catalog {
tournaments: Tournament[];
}| Field | Type | Description |
|---|---|---|
tournaments | Tournament[] | Your entitled tournaments, sorted by from. Can be empty. |
Tournament
interface Tournament {
urn: string;
name: string;
sport: string;
description?: string;
liquipediaUrl?: string;
from?: string;
to?: string;
isOffline: boolean;
matches: Match[];
}| Field | Type | Description |
|---|---|---|
urn | string | The tournament id. Example: "od:tournament:42". |
name | string | Display name. Example: "IEM Katowice 2026". |
sport | string | Sport key. See the list below. Example: "cs2". |
description | string, optional | Free text. Example: "Intel Extreme Masters, …". |
liquipediaUrl | URL string, optional | The tournament's Liquipedia page. Example: "https://liquipedia.net/…". |
from | timestamp string, optional | Planned start of the tournament. Example: "2026-02-01T10:00:00Z". |
to | timestamp string, optional | Planned end of the tournament. Example: "2026-02-14T22:00:00Z". |
isOffline | boolean | The offline flag from the data source, passed through unchanged. In esports, "offline" usually means an on-site (LAN) event, but we don't guarantee that meaning. Example: true. |
matches | Match[] | Its matches, sorted by datePlannedStart. |
sport is one of cs2, dota2, lol, valorant, cs2_duels, dota2_duels, rush_soccer, rush_basketball, rush_cricket, rush_hockey, rush_madden, table_tennis and virtual_soccer. It is unknown for a sport the server does not recognize yet. We add sports over time.
Match
Metadata for one match. It never carries a playback URL: call /v1/playback/{matchUrn} for that.
interface Match {
matchUrn: string;
matchName: string;
datePlannedStart?: string;
status: MatchStatus;
teams?: Team[];
}| Field | Type | Description |
|---|---|---|
matchUrn | string | The match id. Pass it to /v1/playback. Example: "od:match:1234". |
matchName | string | Display name. Use teams to build your own layout. Example: "Team A vs Team B". |
datePlannedStart | timestamp string, optional | Scheduled kickoff. Absent when the match has no schedule. Example: "2026-02-08T18:00:00Z". |
status | MatchStatus | Where the match is now. Example: "live". |
teams | Team[], optional | Home side first. In practice, two entries. |
MatchStatus
type MatchStatus = 'upcoming' | 'pending' | 'live' | 'ended';| Value | Meaning |
|---|---|
upcoming | Before the planned start |
pending | Kickoff has passed and the stream is not playable yet, or it was playing and dropped |
live | Playable now |
ended | Reserved. Not sent today, because a finished match leaves the listing |
A pending match can have a datePlannedStart in the past. That is normal: it covers the few seconds at every match start while packaging finishes. Treat a value you don't know as upcoming.
Team
interface Team {
urn: string;
name: string;
isHome: boolean;
logoUrl?: string;
}| Field | Type | Description |
|---|---|---|
urn | string | The team id. Can be "" when the source sent a name only. Example: "od:competitor:26406". |
name | string | Display name. Example: "Team A". |
isHome | boolean | true for the home side. Example: true. |
logoUrl | URL string, optional | An https logo, about 150 px on the long side. Example: "https://cdn.oddin.gg/…". |
Always render a fallback for a missing logo or one that fails to load. See Teams and logos.
Playback
The body of a 200 from GET /v1/playback/{matchUrn}.
interface Playback {
matchUrn: string;
protocol: 'hls';
mediaType: 'live' | 'vod';
drmEnabled: boolean;
manifestUrl: string;
drm?: Drm;
expiresAt?: string;
serverTime: string;
analytics?: PlaybackAnalytics;
}| Field | Type | Description |
|---|---|---|
matchUrn | string | The match you asked for. Example: "od:match:1234". |
protocol | "hls" | Streaming protocol. Example: "hls". |
mediaType | "live" or "vod" | Always live today. Treat an unknown value as live. Example: "live". |
drmEnabled | boolean | true: set up DRM with drm. false: the stream is clear, skip DRM. Example: true. |
manifestUrl | URL string | The HLS playlist to load. Use it unchanged. Example: "https://…/main.m3u8". |
drm | Drm, optional | The DRM URLs. Present exactly when drmEnabled is true. |
expiresAt | timestamp string, optional | When a signed manifestUrl stops working. At least 12 hours, often days. Example: "2026-05-07T22:00:07Z". |
serverTime | timestamp string | The server clock, to correct for client clock skew. Example: "2026-05-07T10:00:00Z". |
analytics | PlaybackAnalytics, optional | Present only when playback analytics is enabled for your key. |
A session that passes expiresAt gets 403 on its next playlist request. Before that time, resolve again and load the new manifestUrl. expiresAt is absent when the URL is not signed. Use the value from the response: don't compute it from serverTime.
Playback has no kickoff time. Before kickoff you get a 425 instead, and its TooEarlyError carries liveStartsAt.
Drm
interface Drm {
widevine: { licenseUrl: string };
fairplay: { licenseUrl: string; certificateUrl: string };
}| Field | Type | Description |
|---|---|---|
widevine.licenseUrl | URL string | POST Widevine challenges here: Chrome, Firefox, Edge, Android. |
fairplay.licenseUrl | URL string | POST FairPlay challenges here: Safari on macOS and iOS. |
fairplay.certificateUrl | URL string | GET the FairPlay certificate here, with your x-api-key. |
Both license URLs end in a signed query string that is valid for 10 minutes. Each signature is bound to your key, the match and its own endpoint, so a Widevine URL does not work for FairPlay. See License URL lifetime.
PlaybackAnalytics
interface PlaybackAnalytics {
sid: string;
endpoint?: string;
}| Field | Type | Description |
|---|---|---|
sid | string | An opaque session id. It is not a secret. Example: "3f1b9c52-6a0e-4d7b-9e43-2c8d1f0a7b61". |
endpoint | URL string, optional | Where the SDK sends playback quality metrics for this session. Example: "https://…". |
The SDK uses this object to report playback quality. Without the SDK, you can ignore it: playback does not depend on it. Contact havik-support@oddin.gg if you want quality metrics from your own player.
StateEvent
The JSON in each data: line of the event streams.
interface StateEvent {
matchUrn: string;
state: 'upcoming' | 'pending' | 'live' | 'ended' | 'gone';
reason?: 'interrupted' | 'match_ended';
serverTime: string;
}| Field | Type | Description |
|---|---|---|
matchUrn | string | The match this event is about. Example: "od:match:1234". |
state | string | The match's state. See the table in the event stream. Example: "live". |
reason | string, optional | Only on ended. interrupted: the stream dropped. match_ended is reserved. Example: "interrupted". |
serverTime | timestamp string | When the server sent the event. Example: "2026-06-25T12:00:00Z". |
ApiError
The body of every non-2xx response from the API, except 425.
interface ApiError {
error: { code: string; message: string };
}| Field | Type | Description |
|---|---|---|
error.code | string | A stable code. Branch on it. Example: "NOT_FOUND". |
error.message | string | A human-readable sentence. It can change, so don't parse it. Example: "match not found". |
code is one of UNAUTHORIZED, FORBIDDEN, NOT_FOUND, INVALID_URN, TOO_EARLY, GONE, UNAVAILABLE, UPSTREAM_UNAVAILABLE, RATE_LIMITED, TOO_MANY_CONNECTIONS and INTERNAL. TOO_MANY_CONNECTIONS comes from the event streams, when one address opens too many at once.
TooEarlyError
The body of a 425 from /v1/playback. It is an ApiError with one more field.
interface TooEarlyError {
error: { code: 'TOO_EARLY'; message: string };
liveStartsAt?: string;
}| Field | Type | Description |
|---|---|---|
error.code | "TOO_EARLY" | Always TOO_EARLY. Example: "TOO_EARLY". |
error.message | string | A human-readable sentence with the retry delay. Don't parse it. Example: "match has not started; retry in 60s". |
liveStartsAt | timestamp string, optional | Kickoff, for a countdown. Absent once kickoff has passed (pending). Example: "2026-05-07T18:00:00Z". |
DrmError
The body of a non-2xx response from a license or certificate URL. It has a different shape from ApiError.
interface DrmError {
error: string;
}| Field | Type | Description |
|---|---|---|
error | string | A stable code. See License requests. Example: "forbidden". |
Before you go SDK-less
An integration without the SDK is supported, but you then own all the work the SDK does:
- the device id, the license headers and the license URL refresh
- the
425wait with jitter, and the go-live, end and rejoin handling - the player tuning in Tuning your own player
If you only want your own player, keep the SDK for resolution and DRM. That is the Bring your own player mode. It is a few lines of code, and it keeps up with API changes for you.