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:

Orders

https://{shortCode}.api.commercecloud.salesforce.com + /checkout/orders/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
POST/ordersN/A1,000
GET/orders/*N/A4,000
PATCH/orders/*N/A2,400
PUT/orders/*/statusN/A2,400
PUT/orders/*/export-statusN/A4,000
PATCH/orders/*/payment-instruments/*N/A2,400
AllAll remaining endpoints combined.N/A2,400

Shopper Baskets

https://{shortCode}.api.commercecloud.salesforce.com + /checkout/shopper-baskets/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
POST/basketsN/A15,000
POST/baskets/mergeN/A10,000
POST/baskets/transferN/A10,000
GET/baskets/*N/A90,000
All/baskets/**N/A60,000
AllAll remaining endpoints combined.N/A1,000

Shopper Orders

https://{shortCode}.api.commercecloud.salesforce.com + /checkout/shopper-orders/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
POST/ordersN/A1,000
GET/orders/*N/A4,000
PATCH/orders/*N/A2,400
PATCH/orders/*/payment-instruments/*N/A2,400
All/orders/**N/A2,400
AllAll remaining endpoints combined.N/A1,000

The following APIs are included in the product API family:

Products

https://{shortCode}.api.commercecloud.salesforce.com + /product/products/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
GET/products/*600N/A
PUT/products/*20N/A
DELETE/products/*10N/A
PATCH/products/*30N/A
POST/products/*/variant-search200N/A
GET/products/*/variation-groups10N/A
All/products/*/variation-groups/*20N/A
GET/products/*/variations400N/A
All/products/*/variations/*10N/A
GET/products/*/product-options10N/A
All/products/*/product-options/*20N/A
All/products/*/product-options/*/values/*20N/A
All/products/*/variation-attributes/*/values/*50N/A
GET/products/*/variation-attributes70N/A
All/products/*/variation-attributes/*70N/A
POST/product-search100N/A
AllAll remaining endpoints combined.100N/A

Shopper Products

https://{shortCode}.api.commercecloud.salesforce.com + /product/shopper-products/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
All/products28,000N/A
All/categories11,700N/A
AllAll remaining endpoints combined.10N/A

The following APIs are included in the catalog API family:

Catalogs

https://{shortCode}.api.commercecloud.salesforce.com + /product/catalogs/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
GET/catalogs10N/A
GET/catalogs/*10N/A
PATCH/catalogs/*10N/A
GET/catalogs/*/categories10N/A
GET/catalogs/*/categories/*100N/A
All/catalogs/*/categories/*20N/A
POST/categories/*/category-product-assignment-search200N/A
All/categories/*/products/*20N/A
DELETE/categories/*/products/*20N/A
POST/catalogs/*/category-search10N/A
POST/catalog-search10N/A
POST/category-search10N/A
AllAll remaining endpoints combined.50N/A

The following APIs are included in the customer API family:

Customers

https://{shortCode}.api.commercecloud.salesforce.com + /customer/customers/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
POST/customer-lists/*/customer-search270N/A
POST/customer-lists/*/customers10N/A
GET/customer-lists/*/customers/*500N/A
PUT/customer-lists/*/customers/*10N/A
DELETE/customer-lists/*/customers/*20N/A
PATCH/customer-lists/*/customers/*210N/A
GET/customer-lists/*/customers/*/addresses500N/A
POST/customer-lists/*/customers/*/addresses10N/A
GET/customer-lists/*/customers/*/addresses/*30N/A
DELETE/customer-lists/*/customers/*/addresses/*10N/A
PATCH/customer-lists/*/customers/*/addresses/*30N/A
AllAll remaining endpoints combined.20N/A

Shopper Customers

https://{shortCode}.api.commercecloud.salesforce.com + /customer/shopper-customers/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
POST/customers200N/A
POST/customers/actions/login18,700N/A
DELETE/customers/actions/logout100N/A
POST/customers/password/actions/*100N/A
POST/customers/trusted-system/actions/login3,700N/A
GET/customers/*5,500N/A
PATCH/customers/*500N/A
POST/customers/*500N/A
POST/customers/*/addresses/*100N/A
All/customers/*/addresses/*200N/A
GET/customers/*/baskets4,600N/A
GET/customers/*/orders1,300N/A
PUT/customers/*/password100N/A
POST/customers/*/payment-instruments100N/A
All/customers/*/payment-instruments/*100N/A
GET/customers/*/product-lists2,100N/A
POST/customers/*/product-lists200N/A
GET/customers/*/product-lists/*1000N/A
All/customers/*/product-lists/*100N/A
POST/customers/*/product-lists/*/items1,000N/A
All/customers/*/product-lists/*/items/*100N/A
DELETE/customers/*/product-lists/*/items/*3,900N/A
GET/product-lists100N/A
GET/product-lists/* 800N/A
GET/product-lists/*/items/*100N/A
AllAll remaining endpoints combined.200N/A

Shopper Login (SLAS)

SLAS rate limits are impossed on a per-tenant level, irrespective of endpoint use.

  • 24,000 requests per minute per tenant for production instances.
  • 500 requests per minute per tenant for non- production instances.

https://{shortCode}.api.commercecloud.salesforce.com + /customer/shopper-customers/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
GET/product-searchN/A16,400
GET/search-suggestionsN/A7,200
AllAll remaining endpoints combined.N/A7,200

The following APIs are included in the pricing API family:

Assignments

https://{shortCode}.api.commercecloud.salesforce.com + /pricing/assignments/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
POST/assignments800N/A
AllAll remaining endpoints combined.20N/A

Campaigns

https://{shortCode}.api.commercecloud.salesforce.com + /pricing/campaigns/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
POST/campaigns800N/A
GET/campaigns/*800N/A
All/campaigns/*20N/A
AllAll remaining endpoints combined.20N/A

Coupons

https://{shortCode}.api.commercecloud.salesforce.com + /pricing/coupons/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
POST/coupons800N/A
GET/coupons/*800N/A
All/coupons/*20N/A
GET/coupons/*/codes800N/A
POST/coupons/*/codes20N/A
POST/coupons/redemptions800N/A
AllAll remaining endpoints combined.20N/A

Gift Certificates

https://{shortCode}.api.commercecloud.salesforce.com + /gift-certificates/coupons/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
POST/gift-certificates800N/A
GET/gift-certificates/*800N/A
All/gift-certificates/*20N/A
AllAll remaining endpoints combined.20N/A

Promotions

https://{shortCode}.api.commercecloud.salesforce.com + /pricing/promotions/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
POST/promotions800N/A
GET/promotions/*800N/A
All/promotions/*20N/A
AllAll remaining endpoints combined.20N/A

Shopper Promotions

https://{shortCode}.api.commercecloud.salesforce.com + /pricing/shopper-promotions/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 SecondLimit
All/gift-certificate/800N/A
All/promotions800N/A
All/promotions/campaigns/*800N/A
AllAll remaining endpoints combined.800N/A

Source Code Groups

https://{shortCode}.api.commercecloud.salesforce.com + /pricing/source-code-groups/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 SecondLimit
POST/source-code-groups800N/A
GET/source-code-groups/*800N/A
All/source-code-groups/*20N/A
AllAll remaining endpoints combined.20N/A

The following APIs are included in the omnichannel inventory API family:

Inventory Availability

https://{shortCode}.api.commercecloud.salesforce.com + /inventory/availability/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
All/availability-records/actions/get-availabilityN/A60,000
All/availability-records/actions/get-deltasN/A3,000
All/availability-records/actions/batch-updateN/A600
All/locations/{locationId}/availability-records/skus/{sku}/{requestId}N/A600

Inventory Impex

https://{shortCode}.api.commercecloud.salesforce.com + /inventory/impex/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
All/availability-records/exportsN/A2
All/availability-records/exports/{exportId}/statusN/A120
All/availability-records/exports/{exportId}/file-contentN/A2
All/availability-records/exports/{exportId}N/A2
All/availability-records/imports/uploadlink/{uploadLinkId}N/A12
All/availability-records/importsN/A12
All/availability-records/imports/{importId}/statusN/A120
All/availability-records/imports/{importId}N/A12
All/availability-records/exportsN/A2
All/availability-records/exports/{exportId}/statusN/A120
All/availability-records/exports/{exportId}/file-contentN/A2
All/availability-records/exports/{exportId}N/A2

Inventory Reservation

https://{shortCode}.api.commercecloud.salesforce.com + /inventory/reservation/v1/organizations/{organizationId} +

MethodEndpoint5 Second Limit60 Second Limit
All/reservation-documents/{reservationId}N/A60,000
All/transfersN/A60,000
All/releasesN/A60,000
All/fulfillmentsN/A60,000