Error Reference
The following status list and error codes will help you debug issues when working with Brightcove Playback Restrictions:
| Status | Error Code | Error Subcode | Description |
|---|---|---|---|
| 400 | BAD_REQUEST |
DUPLICATE_PARAMETERS |
The same parameter name was provided more than once in the request |
| 401 | ACCESS_DENIED |
TOKEN_REQUIRED |
A JSON Web Token (JWT) is required by Playback Rights but was not provided |
| 401 | ACCESS_DENIED |
TOKEN_VALIDATION |
The JSON Web Token (JWT) provided did not pass validation |
| 403 | ACCESS_DENIED |
ACCOUNT_ID |
The account id in the policy key does not match the account in the API request |
| 403 | ACCESS_DENIED |
CLIENT_GEO |
The video is restricted from playing in the current geographic region; the message will contain additional information about the specific issue |
| 403 | ACCESS_DENIED |
CLIENT_IP |
The video is restricted at the current IP address |
| 403 | ACCESS_DENIED |
DOMAIN |
The video is restricted from playing on the current domain |
| 403 | ACCESS_DENIED |
OFFERS |
The JSON Web Token (JWT) does not allow for playback based on offers available in the video |
| 403 | ACCESS_DENIED |
TAGS |
The JSON Web Token (JWT) does not allow for playback based on tags available in the video |
| 403 | ACCESS_DENIED |
VIDEO_NOT_PLAYABLE |
For a single video request, the video exists, but it is not allowed to be played now |
| 403 | ACCESS_DENIED |
DENIED_BY_STREAM_LIMIT_CREATE [1] |
Limited stream has reached the maximum number of viewers |
| 403 | ACCESS_DENIED |
DENIED_BY_STREAM_LIMIT_RENEW [1] |
Limited stream is already being watched by the maximum number of viewers |
| 403 | ACCESS_DENIED |
DENIED_BY_STREAM_LIMIT [1] |
Limited stream has reached the maximum number of viewers |
| 403 | ACCESS_DENIED |
DENIED_BY_DEVICE_LIMITING [1] |
Limited stream has reached the maximum number of distinct registered devices |
| 404 | NOT_FOUND |
VIDEO_NOT_FOUND |
The requested video is not available |
| 404 | NOT_FOUND |
PLAYLIST_NOT_FOUND |
The requested playlist is not available |
| 405 | METHOD_NOT_ALLOWED |
METHOD_NOT_ALLOWED |
Only GET, HEAD and OPTIONS are allowed for this API |
| 500 | SERVER_ERROR |
SERVER_ERROR |
Internal server error |
| 502 | SERVER_ERROR |
ACCOUNT_RETRIEVE_FAILURE |
Received a bad response from a backend server |
| 502 | SERVER_ERROR |
VIDEO_RETRIEVE_FAILURE |
Video unavailable |
| 502 | SERVER_ERROR |
VIDEO_URLS_RETRIEVE_FAILURE |
Stream URLs unavailable |
| 502 | SERVER_ERROR |
PLAYLIST_RETRIEVE_FAILURE |
Video playlist unavailable |
| 502 | SERVER_ERROR |
PLAYBACK_RIGHT_RETRIEVE_FAILURE |
Cannot retrieve playback right from CDN |
| 502 | SERVER_ERROR |
PLAYLIST_VIDEOS_RETRIEVE_FAILURE |
Playlist videos unavailable |
| 502 | SERVER_ERROR |
LICENSE_RETRIEVE_FAILURE |
Failed to get license from License Server for this video |
| 502 | SERVER_ERROR |
OFFERS_RETRIEVE_FAILURE |
Failed to get offers from API for this video |
| 502 | SERVER_ERROR |
RIGHTS_RETRIEVE_FAILURE |
Failed to retrieve Playback Rights for this video |
| 503 | SERVICE_UNAVAILABLE |
|
Returned this response from a backend server |
| 504 | SERVER_TIMEOUT |
|
Either a backend server or one of the servers they rely on timed out |
Notes
The following notes refer to the integrations in the table above.
[1] Error messages associated with Stream Concurrency and Device Limits are currently NOT available when using the Safari browser.