Status and error codes

You may encounter different HTTP status codes while using our APIs. Below you’ll find a summary of each possible status code.

Status Code	Description
200 OK	OK, all went through!
401 Unauthorized	Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription and that the subscription has not expired.
403 Forbidden	Forbidden; the API key has insufficient permissions to access the resources. Check the message of the response for details, e.g. the subscription or trial period has ended.
404 Not Found	Not Found, search did not find anything!
429 Too Many Requests	Rate limit is exceeded. Too many requests have been made too quickly. Try to wait longer between requests or add an exponential backoff to your calls. Learn more about rate limits and thresholds.
5xx Server Error	Internal Server Error, we had a problem with our server. Try again later.

Rate limits

Below is a breakdown of the rate limits and usage thresholds enforced based on the subscription level of the caller.

Rate limits and thresholds	Trial Subscriptions	Production Subscriptions	Sandbox Subscriptions
Calls per minute	10	480	60
Quota	500 calls	Based on contract term	1,000 calls annually
Expiration	30 days	Based on contract term	Based on contract term

Trial subscriptions

If you are testing our APIs using a trial subscription:

You are rate-limited to 10 calls per minute
You have a quota of 500 calls
You can test our APIs for 30 days, starting from the date your subscription key was issued

Please check the response code description to verify if you encountered any of these thresholds or limits. If you encounter any of these limits or thresholds and would like to upgrade your subscription, contact us using this form.

Production subscriptions

Production subscriptions are rate-limited to 480 calls per minute. Please review your contracting details for the number of calls your subscription allows. We do not place a hard limit on your quota, but you may incur overage charges if you surpass your contracted amount.

Sandbox subscriptions

Sandbox subscriptions are rate-limited to 60 calls per minute. This subscription type is only available under certain circumstances written in your contract. Sandbox subscriptions can only be used for development purposes, and they should never be used in a production environment. The sandbox subscriptions have a 1,000 call quota which resets every year.