Rate Limiting

Amio API has different rate limits for each pricing plan. We limit number of requests you can do within a hour. And number of simultaneous connections you can have opened to Amio servers.

Pricing PlanNumber of RequestsSimultaneous Connections

You can check the returned HTTP headers of any API request to see your current rate limit status for maximum number of requests:

curl -i https://api.amio.io/v1/channels/{{channel_id}}

HTTP/1.1 200 OK
Date: Mon, 01 Jul 2013 17:27:06 GMT
Status: 200 OK
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1491820066
HTTP Response HeaderDescription
X-RateLimit-LimitThe maximum number of requests that you are permitted to make per hour.
X-RateLimit-RemainingRemaining number of requests.
X-RateLimit-ResetRemaining time before the rate limit resets, in UTC epoch seconds.

Once you go over the rate limit you will receive an error response:

  "timestamp": "2016-12-21T11:17:56.397Z",
  "status": {
    "code": "429",
    "message": "Too Many Requests"
  "errors": [
      "message": "You have exceeded maximum number of requests and have been temporarily blocked. See documentation for more details: https://docs.amio.io/reference#rate-limiting"