Skip to main content
Although we strive to provide a seamless and reliable experience, sometimes things can go wrong. In the event of an error, our API provides an error response that contains helpful information to assist you in resolving the issue. The error response includes the status, code, type, and description of the error. The status indicates the general category of the error, while the code and type provide more specific information about the error. The description property provides a detailed explanation of the error and may include suggestions for resolving the issue. Here is an example of an error response: 
{
  "status": "error",
  "code": 101,
  "type": "invalid_key",
  "description": "The API Key is missing or invalid."
}

​
Error codes

CodeTypeDescription
101invalid_keyThe API Key is missing or invalid.
102inactive_userThe API Key owner (the account) is inactive right now. Please contact the support team for more information.
103limit_reachedYou reached the usage limit of your account. Please upgrade your subscription or pay any unpaid invoices.
104invalid_paramsPlease check out the parms parameter’s value.
105plan_expiredYour plan has expired. Renew the subscription to enable using the API.
106flood_detectedOur system has detected too many requests at the same time. Kindly please try to slow down.
108invalid_formatThe value of the format parameter is not a valid format. Use JSON, or XML.
111invalid_modeThe value of the mode parameter is not a valid format. Use test or live.
113domain_not_whitelistedYou are sending the request from a domain that is not the domain name you set in the API settings of your account’s dashboard.
115generic_errorAn error occurred while processing your request. Please try again later.
117feature_not_availableThis feature is not available for your plan, please upgrade your plan first.
120invalid_bin_numberThe BIN number is invalid or missing.
124invalid_user_typeThe user type is invalid or missing. Use email, phone or user_id.
125invalid_user_valueThe user value is invalid or missing (value parameter).
126too_many_deletionsYou have reached the limit of deletions for this day. Please wait until the next day to delete more user data.