TV guide

Get a guide channel's programmes

GET/epg/guide/

read Read: looks, changes nothing. Scopes

What a channel (channel: its guide id) shows now, next and in the hours ahead (24 by default, up to 14 days). Accounts that may add or change streams.

Query parameters

  • channelstringrequired
  • hoursinteger

    Default: 24

Response

200 OK

  • channelobjectrequired

    EpgChannelRef: a channel as pickers and streams show it.

    • idstringrequiredread-only
    • namestringrequiredread-only
    • iconstring (uri)requiredread-only
    • countriesstring[]requiredread-only
    • has_guidebooleanrequiredread-only
  • nowobjectrequiredcan be null
    • startstring (date-time)required
    • stopstring (date-time)required
    • titlestringrequired
    • descriptionstringrequired
  • nextobjectrequiredcan be null
    • startstring (date-time)required
    • stopstring (date-time)required
    • titlestringrequired
    • descriptionstringrequired
  • programmesobject[]required
    • startstring (date-time)required
    • stopstring (date-time)required
    • titlestringrequired
    • descriptionstringrequired

Errors

  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means