Contact Support | System Status
Page Contents

    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 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
    403 FORBIDDEN Denied by stream limiting (create) Limited stream has reached the maximum number of viewers
    403 FORBIDDEN Denied by stream limiting (renew) Limited stream is already being watched by the maximum number of viewers
    403 FORBIDDEN Denied by stream limiting Limited stream has reached the maximum number of viewers
    403 FORBIDDEN Denied by device limiting 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

    Page last updated on 06 Jul 2021