Reference · v1

Endpoint reference

Base URL https://api.os.tv/v1. All endpoints are GET and read-only. Operator endpoints require a domain-administrator token (Authentication).

Integration status public

GET/v1/summaryno auth

Broadcast-feed integration status for the "WWBN Broadcast Feed" card. Not related to the registry counts below.

{ "success": true, "connected": true, "networks": 130, "iptv_networks": 5,
  "ovp_networks": 125, "channels": 705, "programs": 1014,
  "reviews": 130, "pending_reviews": 447, "generated_at": "…" }

Registry summary operator

GET/v1/registry/summarydomain admin

Platform-wide counts across canonical origins and catalog carriages — two separate populations.

Field	Meaning
`canonical_origins`	Total canonical origins.
`reviewed_origins`	Origins with a reviewed crosswalk (presentations resolve).
`governed_origins`	Origins with an active governance edge.
`eligible_unallocated`	Governed origins with no BANS allocation.
`bans_allocated` · `published` · `held`	Allocation totals by publication state.
`catalog_carriages` · `resolved_carriages` · `unresolved_carriages`	Catalog carriage totals.
`transport_inventory`	Catalog carriages by transport. `null` where not classifiable.
`resolved_presentations`	Carriages resolved to an origin, by transport (real integers).

Full response: registry-summary.json.

List origins operator

GET/v1/registry/originsdomain admin

Paginates over canonical origins. Query parameters (all optional):

Parameter	Values
`governance_state`	`governed` · `ungoverned`
`allocation_state`	`allocated` · `unallocated`
`publication_status`	`published` · `held`
`transport`	`iptv` · `ovp` · `ota` · `fast`
`has_presentations`	`true` · `false`
`network_id` · `station_id` · `search`	id · station number · text
`page` · `limit`	default `1` · default `50` (max 200)

See Pagination & filtering and registry-origins.json.

Get one origin operator

GET/v1/registry/origins/{originId}domain admin

originId is wwbn:origin:<uuid> (or the bare uuid). Returns the full per-origin record with all presentations. 404 if unknown. See BANS concepts.

Resolve a BANS address operator

GET/v1/registry/addresses/{address}domain admin

address is a channel-tier BANS address such as 2.0.1. Returns the same record as the id lookup for the origin holding that address; 404 if no origin holds it.

curl -H "Authorization: Bearer <token>" \
  https://api.os.tv/v1/registry/addresses/2.0.1