Documentation

OS.TV API documentation

The OS.TV API is a read model over the WWBN broadcast graph. It never mutates identity, governance or allocation — those happen in the operator tooling. This documentation covers the v1 surface served at https://api.os.tv/v1.

Start here

Getting started

Make your first call to the public /v1/summary endpoint.

Authentication

Bearer token or session cookie, and the 401 / 403 / 200 authorization model for the operator registry.

BANS concepts

Origins, governance, allocation, publication and presentations — and how they stay separate.

Pagination & filtering

How /v1/registry/origins pages over origins and the filters it accepts.

Errors

Status codes and error bodies you should handle.

Endpoint reference

Every endpoint, its parameters and response shape.

Conventions

All responses are JSON with a top-level success boolean (except the 401 body — see Errors).
Timestamps are ISO-8601 UTC (generated_at).
The API is read-only — every endpoint is GET and leaves the broadcast graph unchanged.
Where a value cannot be authoritatively classified, the API returns null — never a fabricated 0.