Error Codes
In case an error occurred while sending the request to our API, you will get an error response. The error response contains code, type and description. Let us show you an example of the error response:
{
"status": "error",
"code": 101,
"type": "invalid_key",
"description": "The API Key is missing or invalid."
}
The following table contains all the possible error codes you need to learn about:
Code
Type
Description
101
invalid_key
The API Key is missing or invalid.
102
inactive_user
The API Key owner (the account) is inactive right now. Kindly please contact the support team for more information.
103
limit_reached
You reached the limit of your plan for this month. Please change your account's plan or wait this month to end.
104
invalid_params
Please check out the parms parameter's value.
105
plan_expired
Your plan has expired. Renew the subscription to enable using the API.
106
flood_detected
Our system has detected too many requests at the same time. Kindly please try to slow down.
107
invalid_callback_name
The value of the callback parameter cannot be a function name.
108
invalid_format
The value of the format parameter is not a valid format. Use JSON, XML or Newline.
109
callback_not_allowd
You can use the callback feature only with the JSON format.
110
invalid_language
The value of the lang parameter is not a valid format. Use EN, AR, FR, DE, ES, JA, ZH or RU.
111
invalid_mode
The value of the mode parameter is not a valid format. Use test or live.
112
invalid_ip
The IP Address is not valid or empty.
113
domain_not_whitelisted
You are sending the request from a domain that is not the domain name you set in the API settings of your account's dashboard.
114
security_module_not_allowed
You cannot use the security module in the free plan. Please upgrade your API plan to unlock this feature.
115
ip_verstion_not_supported
The IP version is not IPv4, which is not supported at the moment.
116
invalid_country_code
The Country Code is invalid or not found.
117
feature_not_available
This feature is not available for your plan, please upgrade your plan first.
Copy link