Bulk Request Limits

Bulk request limits for Emporix API endpoints that support multiple changes in a single request.

Overview

Our default maximum batch size is 200 items. If there are exceptions to it and an endpoint uses a different limit, the API reference for that endpoint specifies it.

Endpoints that allow multiple changes in a single request (bulk or batch operations) are subject to these size limits to ensure stable performance. Exceeding the maximum batch size for an endpoint typically results in a 400 Bad Request with a message indicating the payload or array size limit.

Bulk endpoints and limits

Service	Endpoints	Maximum batch size
Product Service	• Creating multiple products • Upserting multiple products	200
Price Service	• Creating multiple prices • Upserting multiple prices • Deleting multiple prices from a price list • Creating multiple prices for a price list • Upserting multiple prices in a price list	200
Category Tree Service	• Updating assignment of resources to a category • Assigning resources to a category	200
Customer Segment Service	• Creating segments in bulk • Upserting segments in bulk • Deleting segments in bulk • Updating customer assignments in bulk • Removing customer assignments in bulk • Updating item assignments in bulk • Removing item assignments in bulk	200
Schema Service	• Creating custom instances in bulk • Upserting custom instances in bulk	200
Shipping Service	• Creating multiple delivery times	50

In addition to per-endpoint batch size limits, see the following:

• Request/response size for buffered (non-streamed) requests: 10 MB

• Request URL size: 10 KB

• Request header size: 60 KB

Best practices

• Split large datasets into multiple requests if you exceed the limit (for example, more than 200 products in two or more calls for product bulk).

• Stay within the 10 MB request size for the entire request body, including JSON structure.

• Handle 207 Multi-Status responses for bulk operations; each item in the response array corresponds to the same index in the request and may have a different status code.