# 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](https://developer.emporix.io/api-references/api-guides/products-labels-and-brands/product-service)         | <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](https://developer.emporix.io/api-references/api-guides/prices-and-taxes/price-service)                       | <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](https://developer.emporix.io/api-references/api-guides/orders/availability)                           | <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](https://developer.emporix.io/api-references/api-guides/catalogs-and-categories/category-tree)        | <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](https://developer.emporix.io/api-references/api-guides/companies-and-customers/customer-segments) | <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](https://developer.emporix.io/api-references/api-guides/utilities/schema)                                    | <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                |
| [Shipping Service](https://developer.emporix.io/api-references/api-guides/delivery-and-shipping/shipping-1)                  | • [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.