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 Plan

Number of Requests

Simultaneous Connections

Free

1000

3

Developer

2000

10

Enterprise

custom

custom

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 Header

Description

X-RateLimit-Limit

The maximum number of requests that you are permitted to make per hour.

X-RateLimit-Remaining

Remaining number of requests.

X-RateLimit-Reset

Remaining 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"
    }
  ]
}