Error codes

Awario API returns HTTP status codes in addition to JSON-based error codes and messages. Here’s what a JSON error might look like:

{
  "error": {
    "code": 1,
    "message": "No such method."
  }
}

Error codes

Error code	HTTP code	Message	Description
1	404 Not found	No such method	The method requested is invalid or does not exist. You can double-check the list of available methods.
10	503 Service unavailable	System is busy	This code is used when requests are being denied because of the high number of requests from multiple users. You can try again in a few minutes.
11	403 Forbidden	Too many requests per token	This code is used when requests are being denied because of the exceeded rate limit for an API key. You can try again in a few minutes.
12	403 Forbidden	Too many requests per IP address	This code is used when requests are being denied because the rate limit per IP has been reached. You can try again in a few minutes.
20	401 Unauthorized	Invalid access token	Missing or incorrect API key. You can generate a new token in account settings.
21	401 Unauthorized	Your Awario account has expired	Extend your Awario Enterprise plan to continue using API.
22	401 Unauthorized	Your Awario account has been deleted	Renew your Awario Enterprise plan to continue using Awario API.
23	401 Unauthorized	API access is not supported by your Awario plan	Upgrade to Awario Enterprise to start using the API.
30	404 Not found	Alert not found	The alert does not exist or its ID is invalid. You can review the list of available alerts in your account.
40	400 Bad Request	‘<param_name>’ is not specified or contains an invalid value	You can review the list of available parameters for the requested method.
41	400 Bad Request	Statistics for Leads is not supported	Statistics is available for Mention alerts only. You can review the list of available alerts in your account and specify a Mention alert.
50	503 Service unavailable	System is temporarily unavailable	Awario servers are unavailable. You can try again later.
51	503 Service unavailable	We couldn't find your Awario account	You can contact support to resolve the issue.
52	503 Service unavailable	Network error	You can try again later.
53	503 Service unavailable	Request timeout	The request is being processed longer than expected. You can try again later.
54	500 Internal Server Error	Unexpected error	This is usually a temporary error. You can contact support to find out what went wrong.

---