Error codes

Awario API returns HTTP status codes in addition to JSON-based error codes and messages. Here’s how 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 reached 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 the 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 requested 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.