API rate limits

There is some rate limiting in Phone.com API.

Main limitations are:

• 30 requests to one endpoint in 30 seconds for one account.
• 360 requests to one endpoint in 30 seconds from one IP.
• 120 requests to any endpoint in 60 seconds for one account.
• 1440 requests to any endpoint in 60 seconds from one IP.

If you've reached rate limit API will return HTTP Status 429 and similar error object:

{
  "@error": {
    "@message": "Too much requests",
    "@httpStatusCode": 429,
    "@time": "2020-11-13T13:37:16.903Z",
    "@rateLimit": {
      "RateLimit-Limit": 30,
      "RateLimit-Remaining": 0,
      "RateLimit-Reset": 1605274647,
      "Retry-After": 11
    }
  }
}

RateLimit-Reset provides timestamp of the time when you will be able to make API request again.

If you need to increase rate limit for your account or IP address, please, contact our support by email: [email protected].