If an error occurs, an error table like the one below (but containing a single row) will be returned. To test for an error response, look for a 4-column table with columns “Error”, “Description”, “Cause” and “Resolution”. Generic errors like these have IDs below 100. Specific errors have IDs starting at 1000.
IdErrorCauseResolution
-1Unknown errorThe cause of the error is unknown but details have been passed to our support staff who will investigate.These problems are typically short lived and are often resolved by trying again in a few minutes.
2Unknown keyThe key you are using to access the service was not found.Please check that the key is correct. It should be in the form AA11-AA11-AA11-AA11.
3Account out of creditYour account is either out of credit or has insufficient credit to service this request.Please check your account balance and top it up if necessary.
4Request not allowed from this IPThe request was disallowed from the IP address.Check the security settings on the key first. If they look fine, please contact support as it may be from an IP address on our blacklist.
5Request not allowed from this URLThe request was disallowed from the URL.Check the security settings on the key first. If they look fine, please contact support as it may be from a URL on our blacklist.
6Web service not available on this keyThe requested web service is disallowed on this key.Check the security settings on the key first. You can limit a key to certain web services.
7Web service not available on your planThe requested web service is not currently available on your payment plan.Some services are only available in specific regions due to licensing restrictions. Please contact us for more information.
8Key daily limit exceededThe daily limit on the key has been exceeded.Alter the daily limit on the key. Check the usage details first to see if usage is normal.
9Your account has been suspendedYour account has been suspended. This can be for a number of reasons including non-payment of an invoice.Please contact us in order to resolve this issue.
10Surge protector triggeredAn unusually large number of requests have been processed for your account so the surge protector has been enabled.You can disable the surge protector at any time but this is only recommended if you are running through a batch of requests.
11No valid license availableThe request requires a valid license but none were found.Please check your purchase history. You may be using a license that is no longer valid or of an incorrect type.
12Management key requiredTo use this web service you require a management key. Management can be enabled on any key, but we advise you to use management keys with care.Sign in to the website and create a new management key or change an existing key.
13Demo limit exceededThe daily demonstration limit for this service or account has been exceeded.The limit will be reset at midnight tonight. If you would like the limit increased, please contact us.
14Free service limit exceededYou have used too many free web services.Our web services are designed to operate in stages. The first is usually a Find service followed by a Retrieve. If you use too many Finds without the corresponding number of Retrieves you will receive this error. For more information, please contact us.
15Wrong type of keyThe type of key you’re using isn’t supported by this web service.This usually happens if you’re using a user or server license with a web service that only supports transactional keys. Please use another key and try again.
16Key expiredThe key you are trying to use has expired.Please check that you are using the right key. A new one may have been issued if you recently renewed your key. Contact us if you have any questions.
17Individual User exceeded Lookup LimitAn Individual User has exceeded their daily lookup limit on the key and that user will be prevented from using your service until tomorrow (GMT).Check the usage details. If required, increase the Lookup Limit per Individual User or add the specific Individual User’s IP to the Limiter Exclusions.
18Missing or invalid parametersA required parameter was not supplied of the value of a parameter cannnot be converted into the right type.Check the parameters passed and their values against the specification for this service.
19Invalid JSON objectThe JSON object sent in your request is invalid.Please ensure your JSON object is syntactically correct and try again.
20Endpoint not availableThe web service you are calling is not available on this endpoint.Refer to our documentation pages to ensure you are calling a valid endpoint for the web service you are requesting.
21Sandbox Mode is not available on this endpointThe License key used has Sandbox Mode enabled, but the testing functionality is not available on this endpoint.Disable the Sandbox Mode on the License key.
22HTTPS requests onlyAs of 3rd September 2018 all new accounts must use HTTPS.Ensure you consume all of our APIs over HTTPS and not HTTP.
23Agreement Not SignedThere are agreements associated with service which are not signed.Please go to your account and check your agreements.
24Not enough credit for requestThere is not enough credit on the account to process the request.Please top up your account with credit.
25Unexpected error, please contact the help desk for more information