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 CodeTypeDescription
200SuccessThe request completed successfully and content was returned.
204SuccessThe request completed successfully against a valid resource but no content was required to be returned.
400WarningThe request attempted was not accepted by the API.

Please refer to the documentation and check your request.
404WarningThe resource or endpoint attempted to be accessed does not exist.

Please check your request.
*401WarningUnauthorised, you have either not provided an API key or the key provided is not recognised.
*403WarningEither 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.
*500ErrorAn 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