The Logistics API now includes a new batch inventory operations endpoints designed for high-throughput inventory updates. These endpoints let you submit large volumes of inventory data through a CSV file and track the processing asynchronously, making them ideal for full inventory refreshes and bulk synchronizations.
This feature is in early access, which means that we are working to improve it. If you want to use this feature, please contact our Support Center.
What has been added?
Four new endpoints are now available in the Logistics API, under the Batch operations section:
POSTCreate batch inventory job: Creates a new batch inventory job and returns, in the response, both thebatchIdand a pre-signed URL for uploading the CSV file,that are required for the following step (CSV upload). The batch remains inAWAITING_UPLOADstatus until the CSV is uploaded and committed.POSTCommit batch inventory: Confirms that the CSV upload is complete and triggers the asynchronous processing of the batch. The batch status transitions toQUEUED.GETGet batch inventory status: Retrieves the current processing status and progress information for a batch job, including row counts, error counts, and processing stages.GETGet batch inventory errors: Returns a pre-signed URL to download a CSV report with all rows that failed processing, along with error codes and messages.
Why did we make this change?
The existing inventory endpoints remain optimized for low-latency, per-SKU updates, ideal for real-time or incremental inventory changes. However, for scenarios that involve millions of SKUs or require full inventory synchronizations, the new batch endpoints offer a scalable, asynchronous alternative. You do not need to choose between them: both methods can be used together within the same account, depending on the context and business needs.
With this new capability, you can:
- Update large volumes of inventory data in a single operation using CSV files with the batch endpoints, while continuing to use the per-SKU endpoints for more granular or real-time updates.
- Reduce the number of API calls and avoid rate limits when synchronizing inventory at scale.
- Track processing progress and inspect errors through dedicated status and error report endpoints.
What needs to be done?
No changes are required for existing integrations. The previous inventory endpoints remain fully supported and operational.
If you would like to start using the new batch operations endpoints, please see our comprehensive Batch inventory updates guide for step-by-step instructions. You can also refer to the Logistics API reference for detailed endpoint information. Early access is available — contact our Support Center to get started.