Error Reference
The following status list and error codes will help you debug issues when working with Brightcove's Playback Rights Management Service:
| 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 | FORBIDDEN |
ACCOUNT_ID |
The account id in the policy key does not match the account in the API request. |
| 403 | FORBIDDEN |
CLIENT_GEO |
The video is restricted from playing in the current geographic region. The message will contain additional information about the specific issue. |
| 403 | FORBIDDEN |
CLIENT_IP |
The video is restricted at the current IP address. |
| 403 | FORBIDDEN |
DOMAIN |
The video is restricted from playing on the current domain. |
| 403 | FORBIDDEN |
OFFERS |
The JSON Web Token (JWT) does not allow for playback based on offers available in the video. |
| 403 | FORBIDDEN |
TAGS |
The JSON Web Token (JWT) does not allow for playback based on tags available in the video. |
| 403 | FORBIDDEN |
VIDEO_NOT_PLAYABLE |
For a single video request, the video exists, but it is not allowed to be played now. |
| 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 |
|
Only GET, HEAD and OPTIONS are allowed for this API. |
| 500 | 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 |
|
| 502 | SERVER_ERROR |
VIDEO_URLS_RETRIEVE_FAILURE |
|
| 502 | SERVER_ERROR |
PLAYLIST_RETRIEVE_FAILURE |
|
| 502 | SERVER_ERROR |
PLAYBACK_RIGHT_RETRIEVE_FAILURE |
Cannot retrieve playback right from CDN. |
| 502 | SERVER_ERROR |
PLAYLIST_VIDEOS_RETRIEVE_FAILURE |
|
| 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. |