Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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.

Last updated

Was this helpful?