Get the events on a schedule channel
This endpoint retrieves the events scheduled on a Cloud Playout schedule channel, in the order they play. The id in the path is the channel’s ID.
How it works
-
Make a GET request to this endpoint with the
channelId. -
The response returns each event with its type, what it plays, when it runs, and any bumpers attached to it.
-
Narrow the response to a period with
startTimeandendTime. They select events that overlap the window, so an event that started beforestartTimebut is still running at it is included. Either bound can be sent on its own, and leaving both out returns the whole timeline.
Events are returned in full, without pagination. The id must belong to a schedule channel; a loop channel’s id is refused with 400 Channel type mismatch.
Example
A playout dashboard loads tomorrow’s line-up for a channel by asking for the events between midnight and midnight.
Authentication
FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request.
- Username: Access Token ID
- Password: Secret Key
Activate your FastPix account to generate your API credentials. See the guide here
Path parameters
Query parameters
Only return events that are still running at or after this time (an event that started earlier but ends after this time is included), in yyyy-MM-dd'T'HH:mm:ss format and interpreted as UTC. It can be sent on its own to return everything from that point on.
Only return events that start at or before this time, in yyyy-MM-dd'T'HH:mm:ss format and interpreted as UTC. It can be sent on its own to return everything up to that point.