API rate limiting
The Sitecore Send API enforces rate limiting to prevent the API from being overwhelmed by too many requests. This means that it allows only a certain number of API calls from users within a given time. If a user sends too many requests, API rate limiting can throttle client connections.
The following table describes the current rate limit (number of requests per 10 seconds) per user (per API key):
|
Resource |
Method |
Endpoint path |
Rate limit |
|---|---|---|---|
|
Campaign Statistics Activity |
|
|
2 calls / 60s |
|
Add subscribers |
|
|
10 calls / 10s |
|
Add multiple subscribers |
|
|
2 calls / 10s |
|
Unsubscribe a subscriber from an account |
|
|
20 calls / 10s |
|
Unsubscribe a subscriber from an email list |
|
|
20 calls / 10s |
|
Unsubscribe a subscriber from an email list and a campaign |
|
|
20 calls / 10s |
|
Delete a subscriber |
|
|
40 calls / 10s |
|
Delete multiple subscribers |
|
|
8 calls / 10s |
|
Send a transactional campaign |
|
|
6 calls / 1s |
|
Manage a transactional campaign |
|
|
500 |
Example response
The following is an example of a response when request submissions exceed the rate limit. When you go over the rate limit, you receive a RATE_LIMITING error in the response body.
{
"Code": 429,
"Error": "RATE_LIMITING",
"Context": null
}