The OS.TV - WWBN API
A read model for the WWBN broadcast graph. Every broadcaster is one canonical origin; IPTV, OVP, OTA and FAST are presentations of it, not separate catalogs. The Unified BANS Read API returns each origin once — with its identity, governance state, BANS address, publication state and resolved presentations.
Get started → API reference Download OpenAPI
Two surfaces
Public API public
Integration status, no authentication.
Operator Registry operator
The unified per-origin registry. Domain-administrator authentication required.
Base URL & versioning
The subdomain api.os.tv is the API root — there is no /api/… segment. The version lives under /v1/.
https://api.os.tv/v1/summary
https://api.os.tv/v1/registry/summary
https://api.os.tv/v1/registry/origins
https://api.os.tv/v1/registry/origins/{originId}
https://api.os.tv/v1/registry/addresses/{address}The record
One canonical origin, once — six independent facets that are never conflated:
{
"origin": { "id": "wwbn:origin:…", "name": "…", "registry_id": "WWBN-0000000", "network": {…} },
"governance": { "state": "governed" | "ungoverned", "active_edges": 0 },
"bans": { "allocated": true, "address": "2.0.1", "publication_status": "published" | "held", … },
"presentations": [ { "carriage_id": "…", "transport": "iptv", "provider": "…", "availability": "…" } ]
}⛔ reviewed ≠ governed · allocated ≠ published ≠ reachable
Governance
An origin is governed only with an active governance edge. A reviewed crosswalk alone is reviewed, awaiting adoption.
BANS address
A permanent channel-tier address (network.station.channel), earned at governance — never recycled.
Presentations
The transports actually resolved to the origin. Reachability is reported, never inferred from a carriage existing.
Next
Getting started
Your first request in 60 seconds.
Authentication
Bearer token or session cookie; the 401 / 403 / 200 model.
BANS concepts
Origins, governance, allocation, publication, presentations.
Endpoint reference
Every endpoint, parameter and response.