Response Codes
What response codes could I expect to see and when
TV API uses standard HTTP response codes to indicate the success or failure of a request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that failed given the information provided (e.g. a required parameter was omitted, a search request was malformed, etc.) and codes in the 5xx range indicate an error with the TV API servers.
A complete list of possible response codes is as follows:
Response Code | Type | Description |
---|---|---|
200 | Success | The request completed successfully and content was returned. |
204 | Success | The request completed successfully against a valid resource but no content was required to be returned. |
400 | Warning | The request attempted was not accepted by the API. Please refer to the documentation and check your request. |
404 | Warning | The resource or endpoint attempted to be accessed does not exist. Please check your request. |
*401 | Warning | Unauthorised, you have either not provided an API key or the key provided is not recognised. |
*403 | Warning | Either you have attempted to access a resource you are not entitled to access (e.g. a service to which you do not subscribe) or your API key has breached its Quota. |
*500 | Error | An error has occurred with the API. |
*If you're receiving the API as a live service and you see any of these response codes, contact PA Customer Support
Updated less than a minute ago