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