Error codes

All error responses have the same format. The body contains an error code and a message.

{
  "error": "QUOTA_EXCEEDED",
  "message": "Daily request quota exceeded",
  "upgrade_url": "https://app.binlookupapi.com/organisation/org_.../billing"
}

Codes

HTTP status	Error code	Cause	What to do
400	BAD_REQUEST	The request body is not valid.	Check the format of the request. See I get 400 BAD_REQUEST.
401	UNAUTHORIZED	The API key is missing or not valid.	Check the Authorization header. See I get 401 Unauthorized.
403	FORBIDDEN	The key does not have the necessary permission.	Contact support. See I get 403.
403	FEATURE_NOT_AVAILABLE	Your plan does not include this feature.	Open the upgrade_url in the response. See I get 403.
404	NOT_FOUND	The BIN is not in the data.	Try more digits. See Why a BIN returns NOT_FOUND.
429	QUOTA_EXCEEDED	You used your daily quota.	Wait for the reset, or upgrade. See I get 429 sooner than expected.
502	SERVICE_ERROR	An internal error occurred.	Try again later.

The upgrade_url field

Some error responses contain an upgrade_url field. This URL opens the Billing page of your organisation.