Playback Restrictions Error Reference

This topic provides an error reference for Brightcove Playback Restrictions.

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.