Rate Limits
The Salesforce Commerce API has rate limits in place for the number of requests allowed per unit of time. When the number of requests received reaches the rate limit, the API returns an HTTP 429 response.
Each API family has defined settings for different endpoints to ensure a consistent quality of service and improve platform stability. Customers can rely on a defined service availability and a consistent quality across APIs.
Rate limits apply to most B2C Commerce implementations. However, the limits can be adjusted based on specific customer scenarios or use cases. In addition, there can be additional factors that can contribute to the expected performance of API responses. Therefore, the rates listed here are not guarantees. For further details, please refer to Governance and Quotas in our Commerce Cloud B2C documentation.
Contact your Customer Success Manager or Account Executive for questions around rate limits, use cases, and potential adjustments required for these rates.
In the tables below you can see the rate limits for different API families. The limit column shows the maximum number of requests allowed for specific endpoints.
All endpoints that are not individually called out in the following tables have a cumulative rate limit, and are not throttled on a per-endpoint basis. For example, a POST method may have a individual specified rate limit for an endpoint, while the GET, PUT, and DELETE methods are combined to reach the specified rate limit. Or if not specified at all, the endpoints are counted together for the cumulative default rate.
The following APIs are included in the checkout API family:
https://{shortCode}.api.commercecloud.salesforce.com +
/checkout/orders/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| POST | /orders | N/A | 1,000 |
| GET | /orders/* | N/A | 4,000 |
| PATCH | /orders/* | N/A | 2,400 |
| PUT | /orders/*/status | N/A | 2,400 |
| PUT | /orders/*/export-status | N/A | 4,000 |
| PATCH | /orders/*/payment-instruments/* | N/A | 2,400 |
| All | All remaining endpoints combined. | N/A | 2,400 |
https://{shortCode}.api.commercecloud.salesforce.com +
/checkout/shopper-baskets/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| POST | /baskets | N/A | 15,000 |
| POST | /baskets/merge | N/A | 10,000 |
| POST | /baskets/transfer | N/A | 10,000 |
| GET | /baskets/* | N/A | 90,000 |
| All | /baskets/** | N/A | 60,000 |
| All | All remaining endpoints combined. | N/A | 1,000 |
https://{shortCode}.api.commercecloud.salesforce.com +
/checkout/shopper-orders/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| POST | /orders | N/A | 1,000 |
| GET | /orders/* | N/A | 4,000 |
| PATCH | /orders/* | N/A | 2,400 |
| PATCH | /orders/*/payment-instruments/* | N/A | 2,400 |
| All | /orders/** | N/A | 2,400 |
| All | All remaining endpoints combined. | N/A | 1,000 |
The following APIs are included in the product API family:
https://{shortCode}.api.commercecloud.salesforce.com +
/product/products/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| GET | /products/* | 600 | N/A |
| PUT | /products/* | 20 | N/A |
| DELETE | /products/* | 10 | N/A |
| PATCH | /products/* | 30 | N/A |
| POST | /products/*/variant-search | 200 | N/A |
| GET | /products/*/variation-groups | 10 | N/A |
| All | /products/*/variation-groups/* | 20 | N/A |
| GET | /products/*/variations | 400 | N/A |
| All | /products/*/variations/* | 10 | N/A |
| GET | /products/*/product-options | 10 | N/A |
| All | /products/*/product-options/* | 20 | N/A |
| All | /products/*/product-options/*/values/* | 20 | N/A |
| All | /products/*/variation-attributes/*/values/* | 50 | N/A |
| GET | /products/*/variation-attributes | 70 | N/A |
| All | /products/*/variation-attributes/* | 70 | N/A |
| POST | /product-search | 100 | N/A |
| All | All remaining endpoints combined. | 100 | N/A |
https://{shortCode}.api.commercecloud.salesforce.com +
/product/shopper-products/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| All | /products | 28,000 | N/A |
| All | /categories | 11,700 | N/A |
| All | All remaining endpoints combined. | 10 | N/A |
The following APIs are included in the catalog API family:
https://{shortCode}.api.commercecloud.salesforce.com +
/product/catalogs/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| GET | /catalogs | 10 | N/A |
| GET | /catalogs/* | 10 | N/A |
| PATCH | /catalogs/* | 10 | N/A |
| GET | /catalogs/*/categories | 10 | N/A |
| GET | /catalogs/*/categories/* | 100 | N/A |
| All | /catalogs/*/categories/* | 20 | N/A |
| POST | /categories/*/category-product-assignment-search | 200 | N/A |
| All | /categories/*/products/* | 20 | N/A |
| DELETE | /categories/*/products/* | 20 | N/A |
| POST | /catalogs/*/category-search | 10 | N/A |
| POST | /catalog-search | 10 | N/A |
| POST | /category-search | 10 | N/A |
| All | All remaining endpoints combined. | 50 | N/A |
The following APIs are included in the customer API family:
https://{shortCode}.api.commercecloud.salesforce.com +
/customer/customers/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| POST | /customer-lists/*/customer-search | 270 | N/A |
| POST | /customer-lists/*/customers | 10 | N/A |
| GET | /customer-lists/*/customers/* | 500 | N/A |
| PUT | /customer-lists/*/customers/* | 10 | N/A |
| DELETE | /customer-lists/*/customers/* | 20 | N/A |
| PATCH | /customer-lists/*/customers/* | 210 | N/A |
| GET | /customer-lists/*/customers/*/addresses | 500 | N/A |
| POST | /customer-lists/*/customers/*/addresses | 10 | N/A |
| GET | /customer-lists/*/customers/*/addresses/* | 30 | N/A |
| DELETE | /customer-lists/*/customers/*/addresses/* | 10 | N/A |
| PATCH | /customer-lists/*/customers/*/addresses/* | 30 | N/A |
| All | All remaining endpoints combined. | 20 | N/A |
https://{shortCode}.api.commercecloud.salesforce.com +
/customer/shopper-customers/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| POST | /customers | 200 | N/A |
| POST | /customers/actions/login | 18,700 | N/A |
| DELETE | /customers/actions/logout | 100 | N/A |
| POST | /customers/password/actions/* | 100 | N/A |
| POST | /customers/trusted-system/actions/login | 3,700 | N/A |
| GET | /customers/* | 5,500 | N/A |
| PATCH | /customers/* | 500 | N/A |
| POST | /customers/* | 500 | N/A |
| POST | /customers/*/addresses/* | 100 | N/A |
| All | /customers/*/addresses/* | 200 | N/A |
| GET | /customers/*/baskets | 4,600 | N/A |
| GET | /customers/*/orders | 1,300 | N/A |
| PUT | /customers/*/password | 100 | N/A |
| POST | /customers/*/payment-instruments | 100 | N/A |
| All | /customers/*/payment-instruments/* | 100 | N/A |
| GET | /customers/*/product-lists | 2,100 | N/A |
| POST | /customers/*/product-lists | 200 | N/A |
| GET | /customers/*/product-lists/* | 1000 | N/A |
| All | /customers/*/product-lists/* | 100 | N/A |
| POST | /customers/*/product-lists/*/items | 1,000 | N/A |
| All | /customers/*/product-lists/*/items/* | 100 | N/A |
| DELETE | /customers/*/product-lists/*/items/* | 3,900 | N/A |
| GET | /product-lists | 100 | N/A |
| GET | /product-lists/* | 800 | N/A |
| GET | /product-lists/*/items/* | 100 | N/A |
| All | All remaining endpoints combined. | 200 | N/A |
SLAS rate limits are impossed on a per-tenant level, irrespective of endpoint use.
- 24,000 requests per minute (RPM) per tenant for production instances.
- 500 RPM per tenant for non-production instances.
- 25 RPM for the following endpoints:
/oauth2/jwksand/oauth2/.well-known/openid-configuration
https://{shortCode}.api.commercecloud.salesforce.com +
/customer/shopper-customers/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| GET | /product-search | N/A | 16,400 |
| GET | /search-suggestions | N/A | 7,200 |
| All | All remaining endpoints combined. | N/A | 7,200 |
The following APIs are included in the pricing API family:
https://{shortCode}.api.commercecloud.salesforce.com +
/pricing/assignments/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| POST | /assignments | 800 | N/A |
| All | All remaining endpoints combined. | 20 | N/A |
https://{shortCode}.api.commercecloud.salesforce.com +
/pricing/campaigns/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| POST | /campaigns | 800 | N/A |
| GET | /campaigns/* | 800 | N/A |
| All | /campaigns/* | 20 | N/A |
| All | All remaining endpoints combined. | 20 | N/A |
https://{shortCode}.api.commercecloud.salesforce.com +
/pricing/coupons/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| POST | /coupons | 800 | N/A |
| GET | /coupons/* | 800 | N/A |
| All | /coupons/* | 20 | N/A |
| GET | /coupons/*/codes | 800 | N/A |
| POST | /coupons/*/codes | 20 | N/A |
| POST | /coupons/redemptions | 800 | N/A |
| All | All remaining endpoints combined. | 20 | N/A |
https://{shortCode}.api.commercecloud.salesforce.com +
/gift-certificates/coupons/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| POST | /gift-certificates | 800 | N/A |
| GET | /gift-certificates/* | 800 | N/A |
| All | /gift-certificates/* | 20 | N/A |
| All | All remaining endpoints combined. | 20 | N/A |
https://{shortCode}.api.commercecloud.salesforce.com +
/pricing/promotions/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 Second Limit |
|---|---|---|---|
| POST | /promotions | 800 | N/A |
| GET | /promotions/* | 800 | N/A |
| All | /promotions/* | 20 | N/A |
| All | All remaining endpoints combined. | 20 | N/A |
https://{shortCode}.api.commercecloud.salesforce.com +
/pricing/shopper-promotions/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 SecondLimit |
|---|---|---|---|
| All | /gift-certificate/ | 800 | N/A |
| All | /promotions | 800 | N/A |
| All | /promotions/campaigns/* | 800 | N/A |
| All | All remaining endpoints combined. | 800 | N/A |
https://{shortCode}.api.commercecloud.salesforce.com +
/pricing/source-code-groups/v1/organizations/{organizationId} +
| Method | Endpoint | 5 Second Limit | 60 SecondLimit |
|---|---|---|---|
| POST | /source-code-groups | 800 | N/A |
| GET | /source-code-groups/* | 800 | N/A |
| All | /source-code-groups/* | 20 | N/A |
| All | All remaining endpoints combined. | 20 | N/A |
OCI has specific rate limits that have been set by endpoint. If you exceed the allowed rates by endpoint, you will receive HTTP 429 Rate Limit error responses until you have delayed your requests long enought to return to the proper limits.
Please be aware that the rate limits defined for OCI are rolling rate limits. This means that there is a maximum number of concurrent requests allowed per time period defined. This helps OCI to prevent denial-of-service attacks by limiting the amount of traffic that can be sent from one organization over that defined period. The limit is measured in seconds and will reset at regular intervals so it's always "rolling" forward. If any organization exceeds it's allotted quota for too long, it will be blocked until its usage drops below the threshold again. By setting these rules, OCI is able to detect suspicious activity and block the traffic before it becomes a problem for all consumers of the service.
Rate limits are outlined below, by service, by endpoint, and by request type.
The following APIs are included in the omnichannel inventory API family:
Base URI: https://{shortCode}.api.commercecloud.salesforce.com +
/inventory/availability/v1/organizations/{organizationId} +
| Method | Endpoint | Requests | Second(s) |
|---|---|---|---|
| POST | /availability-records/actions/batch-update | 100 | 10 |
| POST | /availability-records/actions/get-deltas | 500 | 10 |
| POST | /availability-records/actions/get-availability | 10,000 | 10 |
| POST | /product-segmentation/actions/batch-update | N/A | N/A |
| DELETE | /locations/{locationId}/availability-records/skus/{sku}/{requestId} | 12000 | 10 |
| PUT | /locations/{locationId}/availability-records/skus/{sku}/{requestId} | 100 | 10 |
| PATCH | /locations/{locationId}/availability-records/skus/{sku}/{requestId} | 100 | 10 |
Base URI: https://{shortCode}.api.commercecloud.salesforce.com +
/inventory/impex/v1/organizations/{organizationId} +
| Method | Endpoint | Requests | Second(s) |
|---|---|---|---|
| POST | /location-graph/exports | 2 | 60 |
| DELETE | /location-graph/exports/{exportId} | 2 | 60 |
| GET | /transfers/location-graph/exports/{exportId}/file-content | 2 | 60 |
| GET | /location-graph/exports/{exportId}/status | 20 | 10 |
| POST | /availability-records/imports | 2 | 10 |
| GET | /availability-records/imports | 2 | 10 |
| DELETE | /availability-records/imports/{importId} | 2 | 10 |
| GET | /availability-records/imports/{importId}/status | 20 | 10 |
| GET | /availability-records/imports/{importId}/file-content | 2 | 10 |
| POST | /availability-records/imports/uploadlink/{uploadLinkId} | 2 | 10 |
| POST | /product-segmentation/imports | 2 | 60 |
| DELETE | /product-segmentation/imports/{importId} | 2 | 60 |
| GET | /product-segmentation/imports/{importId}/file-content | 40 | 60 |
| GET | /product-segmentation/imports/{importId}/status | 20 | 10 |
| POST | /product-segmentation/imports/uploadLink/{uploadLinkId} | 2 | 60 |
| POST | /product-segmentation/exports | 40 | 60 |
| DELETE | /product-segmentation/exports/{exportId} | 40 | 60 |
| GET | /product-segmentation/exports/{exportId}/file-content | 40 | 60 |
| GET | /product-segmentation/exports/{exportId}/status | 20 | 10 |
| POST | /availability-records/exports | 40 | 60 |
| DELETE | /availability-records/exports/{exportId} | 40 | 60 |
| GET | /availability-records/exports/{exportId}/file-content | 40 | 60 |
| GET | /availability-records/exports/{exportId}/status | 20 | 10 |
| POST | /event-log/exports | 40 | 60 |
| GET | /event-log/exports/{exportId}/status | 40 | 60 |
| GET | /event-log/exports/{exportId}/file-content | 40 | 60 |
Base URI: https://{shortCode}.api.commercecloud.salesforce.com +
/inventory/reservation/v1/organizations/{organizationId} +
| Method | Endpoint | Requests | Second(s) |
|---|---|---|---|
| PUT | /reservation-documents/{reservationId} | 10,000 | 10 |
| PATCH | /reservation-documents/{reservationId} | 10,000 | 10 |
| POST | /transfers | 10,000 | 10 |
| POST | /releases | 10,000 | 10 |
| POST | /fulfillments | 10,000 | 10 |