# Bulk Request Limits

## 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](/api-references/api-guides/products-labels-and-brands/product-service.md)         | <p>• <a href="https://developer.emporix.io/api-references/api-guides/products-labels-and-brands/product-service/api-reference/products#post-product-tenant-products-bulk">Creating multiple products</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/products-labels-and-brands/product-service/api-reference/products#put-product-tenant-products-bulk">Upserting multiple products</a></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 200                |
| [Price Service](/api-references/api-guides/prices-and-taxes/price-service.md)                       | <p>• <a href="https://developer.emporix.io/api-references/api-guides/prices-and-taxes/price-service/api-reference/prices#post-price-tenant-prices-bulk">Creating multiple prices</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/prices-and-taxes/price-service/api-reference/prices#put-price-tenant-prices-bulk">Upserting multiple prices</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/prices-and-taxes/price-service/api-reference/prices-assigned-to-price-lists#delete-price-remove-multiple-prices-from-price-list">Deleting multiple prices from a price list</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/prices-and-taxes/price-service/api-reference/prices-assigned-to-price-lists#post-price-create-multiple-prices-for-price-list">Creating multiple prices for a price list</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/prices-and-taxes/price-service/api-reference/prices-assigned-to-price-lists#put-price-update-multiple-prices-in-price-list">Upserting multiple prices in a price list</a></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 200                |
| [Availability Service](/api-references/api-guides/orders/availability.md)                           | <p>• <a href="https://developer.emporix.io/api-references/api-guides/orders/availability/api-reference/availabilities#post-availability-tenant-availability-bulk">Creating multiple product availabilities</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/orders/availability/api-reference/availabilities#put-availability-tenant-availability-bulk">Upserting multiple availabilities information of a product</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/orders/availability/api-reference/availabilities#delete-availability-tenant-availability-bulk">Deleting availability information of a product</a></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 200                |
| [Category Tree Service](/api-references/api-guides/catalogs-and-categories/category-tree.md)        | <p>• <a href="https://developer.emporix.io/api-references/api-guides/catalogs-and-categories/category-tree/api-reference/category-assignment-resources#put-category-tenant-categories-categoryid-assignments-references-bulk">Updating assignment of resources to a category</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/catalogs-and-categories/category-tree/api-reference/category-assignment-resources#post-category-tenant-categories-categoryid-assignments-bulk">Assigning resources to a category</a></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 200                |
| [Customer Segment Service](/api-references/api-guides/companies-and-customers/customer-segments.md) | <p>• <a href="https://developer.emporix.io/api-references/api-guides/companies-and-customers/customer-segments/api-reference/segments#post-customer-segment-tenant-segments-bulk">Creating segments in bulk</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/companies-and-customers/customer-segments/api-reference/segments#put-customer-segment-tenant-segments-bulk">Upserting segments in bulk</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/companies-and-customers/customer-segments/api-reference/segments#delete-customer-segment-tenant-segments-bulk">Deleting segments in bulk</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/companies-and-customers/customer-segments/api-reference/customers-assignments#put-customer-segment-tenant-segments-segmentid-customers-bulk">Updating customer assignments in bulk</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/companies-and-customers/customer-segments/api-reference/customers-assignments#delete-customer-segment-tenant-segments-segmentid-customers-bulk">Removing customer assignments in bulk</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/companies-and-customers/customer-segments/api-reference/items-assignments#put-customer-segment-tenant-segments-segmentid-items-type-bulk">Updating item assignments in bulk</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/companies-and-customers/customer-segments/api-reference/items-assignments#delete-customer-segment-tenant-segments-segmentid-items-type-bulk">Removing item assignments in bulk</a></p> | 200                |
| [Schema Service](/api-references/api-guides/utilities/schema.md)                                    | <p>• <a href="https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-instance#post-schema-tenant-custom-entities-type-instances-bulk">Creating custom instances in bulk</a><br>• <a href="https://developer.emporix.io/api-references/api-guides/utilities/schema/api-reference/custom-instance#put-schema-tenant-custom-entities-type-instances-bulk">Upserting custom instances in bulk</a></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 200                |
| [Cart Service](/api-references/api-guides/checkout/cart.md)                                         | • [Updating multiple products in cart](https://developer.emporix.io/api-references/api-guides/checkout/cart/api-reference/cart#put-cart-update-multiple-items-in-cart)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 50                 |
| [Shipping Service](/api-references/api-guides/delivery-and-shipping/shipping-1.md)                  | • [Creating multiple delivery times](https://developer.emporix.io/api-references/api-guides/delivery-and-shipping/shipping/api-reference/delivery-times-management#post-shipping-create-delivery-times-bulk)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.emporix.io/api-references/standard-practices/bulk-request-limits.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
