Screener Room Passcode Retrieve

watch.content.screener_room_passcode.retrieve

This API issues a short lived passcode for a screener room, for use when pairing a TV app to the room.

Each call invalidates any passcode previously issued for the screener room and returns a new one, so a passcode should be requested only when it is about to be shown to the viewer.

Headers

Header	Value
Authorization	Bearer api_key
ClientID	platform-\<id>-app_version-\<id>

The ClientID header is required. It must have four hyphen-separated components, and the first component must be one of web, roku, firestick, fireos, appletv, ipad, tizen.

Endpoint

GET v2/watch/content/screener-rooms/{screener_room_key}/passcode

Response Body

    {
        "passcode": "418362",
        "expiry": 1719599515,
        "status_code": "W0000",
        "status_message": "Success"
    }

Field	Type	Description
passcode	String	The passcode to enter in the TV app.
expiry	Integer	When the passcode stops being valid, as a Unix timestamp.
status_code	String	The Indee status code for the response.
status_message	String	Human readable message describing the response.

Status Codes

Indee status code	HTTP Response Code	Description
W0000	HTTP 200	Success
W2000	HTTP 401	Authorization header was either not passed or there was some issue parsing it
W2001	HTTP 401	API key is invalid or expired, or is not fully configured
W2009	HTTP 401	ClientID header was either not passed or is malformed
W2100	HTTP 403	Not authorized for this screener room. Raised when the origin domain is not whitelisted, or the screener room belongs to a different watch product
W2104	HTTP 403	Watching on TV is not available on the plan for this title
W2108	HTTP 403	Watch product is inactive
W2102	HTTP 451	Request blocked by geofencing for the resolved region
W4202	HTTP 400	The specified screener room key does not exist
W5001	HTTP 429	Rate limited
W5000	HTTP 500	Unknown server error occurred