Skip to main content
The Affinity API sets a limit on the number of calls that a user can make per minute, and that all the users on an account can make per month. It also sets a reasonable limit on the number of concurrent requests it will support from an account at one time. Requests to both Affinity API versions will count toward the one pool of requests allowed for a user or account. Once a per-minute, monthly, or concurrent rate limit is hit, subsequent requests will return an error code of 429. We highly recommend designing your application to handle 429 errors.

Per-Minute Limits (User-Level)

To help protect our systems, API requests will be halted at 900 per user, per minute. We may also lower this limit on a temporary basis to manage API availability.

Concurrent Request Limits (Account-Level)

To protect our systems and manage availability across customers, we set a reasonable limit on concurrent requests at the account level. Customers should not expect to hit this limit unless they are hitting the API with heavy operations from many concurrent threads at once.

Monthly Plan Tier Limits (Account-Level)

The overall number of requests you can make per month will depend on your account’s plan tier. This monthly account-level limit resets at the end of each calendar month. Current rate limits by plan tier are:
Plan TierCalls Per Month
EssentialsNone
Scale100k
Advanced100k
EnterpriseUnlimited*
*Per-Minute and Concurrent Request Limits still apply.

Rate Limit Headers

All API calls will return the following response headers with information about per-minute and monthly limits:
HeaderDescription
x-ratelimit-limit-userNumber of requests allowed per minute for the user
x-ratelimit-limit-user-remainingNumber of requests remaining for the user
x-ratelimit-limit-user-resetTime in seconds before the limit resets for the user
x-ratelimit-limit-orgNumber of requests allowed per month for the account
x-ratelimit-limit-org-remainingNumber of requests remaining for the account
x-ratelimit-limit-org-resetTime in seconds before the limit resets for the account