Frisbii Billing and Pay imposes the following request limits on the usage of API.
- 25 req / sec for read requests (
GET) with the possibility to burst up to 50 req / sec for shorter periods of time. - 10 req / sec for write requests (
POST|PUT|DELETE) with the possibility to burst up to 25 req / sec for shorter periods of time. - 10 concurrent read requests.
- 10 concurrent write requests.
In the case these limits are exceeded a 429 HTTP error response is returned. The code in the error response indicates if rate or concurrent limit has been exceeded (122 and 123 respectively).
It is unlikely to experience request limits with normal usage of the API, even at high volume. The most common causes for exceeding the limits are bugs, bulk data processing or load testing. Should your requests begin to receive 429 HTTP errors, reduce the frequency of your requests. Each failed request is perfectly safe to retry as rate limiting takes place before any other action and prevents the request from being processed. When reducing your request frequency, we recommend an exponential backoff by first waiting one second before trying again. If your request continues to receive the same response, wait two seconds, then four seconds, etc.
Test accounts have the same limits as live accounts, plus an hourly limit:
- 9,000 read requests per hour.
- 3,600 write requests per hour.
The hourly limits leave room for integration and CI test suites, but not for load or volume testing. When an hourly limit is exceeded, a 429 HTTP error response with code 122 is returned until the number of requests within the last hour is below the limit again, so backing off for a few seconds will not help.
If you are experiencing rate limits but are unable to determine why, please contact us at [email protected].
We urge you to use the API in a fair manner, not introducing unnecessary load. E.g. to use webhooks instead of polling for events, and limit the number of threads to use for bulk operations. We consider it unfair API usage if the API usage is not proportional to the number of entities managed at Frisbii Billing and Pay. Constantly retrieving all data from Frisbii Billing and Pay is an example of what we would consider unfair API usage.
Frisbii Billing and Pay monitors API usage over longer periods to identity excessive API usage. We will try to get in contact on excessive use, but we may be forced to reduce limits until the matter has been resolved.
