Errors

We use standard HTTP Error codes - some are detailed below for reference. Additionally, where an error has occurred we attempt to return the message in the JSON response in either messages or error_messages

The response section of the API response details the HTTP response codes. HTTP response codes are also set but we would recommend parsing the response section of the returned JSON for errors rather than relying on the HTTP response code.

code	code_description	message / details
200	Ok	The query was successful irrespective of whether the results give a positive response
400	Bad Request	Likely returned if a parameter is missing from a query. The message value will detail the parameter that is missing. Check this documentation for the correct parameter values.
401	Unauthorized	It's likely your Subscription Key or API Key are not valid
403	Forbidden	Your subscription doesn't allow for the call made or you've implemented Whitelist restrictions in your control panel - please check these settings allow your system to connect
404	Not Found	You've requested a page or search query that doesn't exist. PLEASE NOTE - we also return a 404 in the event that no results have been found
422	Unprocessable	The structure of the query is correct, but one of the parameters contains an invalid value. Where possible, the system will use default values to mitigate but this isn't always possible.
503	Maintenance	We're currently undertaking some maintenance. We currently have a nightly maintenance routine that runs for circa 1 hour.