Show the navigation →

Handling API Errors

If we run into an error while processing your request, we will attempt to return an object with a single "error" property which describes the problem in detail. We cannot guarantee that this will be the response depending on the error that occurred.

Example

{"error": "No API key entered in the password of the authentication of this request."}

HTTP Status Codes

Status CodeDescription
200Your request was resolved successfully.
400One or more of the parameters you provided are invalid.
401The API key you provided is invalid.
402We were unable to collect payment for your request.
403API access has been disabled on your account.
404The specified item does not exist in our system.
429 You have reached your free search result limit for the day, and the API does not have access to draw from your lump sum balance. Please wait until your next search is available or review your settings.
500 An unexpected error occurred while resolving your request. Please wait a minute and then try again, or contact support if the problem persists.
503 We are temporarily unable to handle your request. Please wait a minute and then try again.