| Code | Status | Description |
|---|---|---|
| 200 | OK | The request was successful |
| 403 | Forbidden | Access is denied. If distribution restrictions are active — geo-restriction or token authentication — the request must satisfy those conditions |
| 404 | Not Found | The requested video does not exist or is inactive, or the live stream is not producing chunks. Check the request URL and video status. For CMAF live streams, check the X-Err-Code response header — see the table below |
| 422 | Unprocessable Content | The request requires custom encoding functionality that is not enabled for the account. Contact support to enable custom encoding presets |
| 500 | Internal Server Error | An unexpected error occurred while processing the request. This is usually isolated to a specific video — verify the video processing status in the account. If the issue affects multiple streams or videos, current outages appear on the Gcore status page |
| 502 | Bad Gateway | The CDN received an invalid response from the VOD storage or live transcoder. Check the video processing status or live stream transcoding in the account. If the issue affects multiple streams or videos, current outages appear on the Gcore status page |
| 503 | Service Unavailable | The server is temporarily unable to process the request. Retry after a short delay. For persistent errors, check the video processing status in the account. If the issue affects multiple streams or videos, current outages appear on the Gcore status page |
| 504 | Gateway Time-out | Timeout receiving data from the source. Check whether the source is sending data and whether ingest and transcoding are active |
X-Err-Code header for CMAF live streams
For CMAF live streams, a 404 response includes anX-Err-Code header with a numeric code that identifies the specific failure:
| X-Err-Code | Description |
|---|---|
| 1000 | Master stream is missing. No stream is being ingested, or transcoding is not producing output. Start sending the stream or restart transcoding |
| 2000 | Invalid StreamID. The identifier could not be parsed from the requested URL — check the URL |
| 3000 | Stream is not ready for delivery, typically because of invalid master-stream parameters — video or audio codec, FPS, or bitrate. Check the encoder parameters and logs. If the issue persists, contact support |