OSAPI.os.tv
Guide

Getting started

The fastest path is the public integration-status endpoint — no credentials required.

1 · Base URL

Everything lives under the versioned base URL. The subdomain is the API root, so there is no /api/… segment.

https://api.os.tv/v1

2 · Your first request public

GET /v1/summary returns broadcast-feed integration status. It needs no authentication.

curl https://api.os.tv/v1/summary
{
  "success": true,
  "connected": true,
  "networks": 130,
  "iptv_networks": 5,
  "ovp_networks": 125,
  "channels": 705,
  "programs": 1014,
  "reviews": 130,
  "pending_reviews": 447,
  "generated_at": "2026-07-30T15:42:30.875Z"
}

3 · The unified registry operator

The per-origin registry under /v1/registry/* requires domain-administrator authentication (see Authentication). Anonymous requests receive 401.

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

See the registry summary example for the full response shape, and BANS concepts for what each field means.

The registry is a projection. Every call is GET and read-only — it never changes governance, allocation or the broadcast graph.

Next

Authentication → · BANS concepts → · Reference →