# Rate Limits

ABSTRACT
SalesTim API allows you to access data and to perform operations on multiple services. These services impose their own rate limits that affect applications that use SalesTim API to access them.


TABLE OF CONTENTS


# Overview of rate limit tiers

Rate limits are defined as "tiers" applied on a "per user (or app) per tenant" basis.

Note

The specific limits described here are subject to change.

Feature/API Limit Notes
Tier 1 6 per minute Access tier 1 methods infrequently. A small amount of burst behavior is tolerated.
Tier 2 20 per minute Access tier 2 methods on a regular basis. Allowed for occasional bursts of more requests.
Tier 3 60 per minute Tier 3 methods allow a larger number of requests and are typically attached to methods with paginating collections of resources. Sporadic bursts are welcome.

# What happens when your is exceeding a limit?

When a threshold is exceeded, SalesTim API limits any further requests from that client for a period of time. When throttling occurs, SalesTim API returns HTTP status code 429 (Too many requests), and the requests fail.

See the Throttling Guidance article to understand how to properly handle throttled requests.

classification:PUBLIC