---
title: "New Orders - Batch"
method: POST
path: "/v1/cart/orders/batch"
tags: ["Cart API"]
---

# New Orders - Batch

`POST /v1/cart/orders/batch`

## Request

- Base URL: `http://{{base_url}}`
- URL: `http://{{base_url}}/v1/cart/orders/batch`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover/docs/v1/cart/orders/batch/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint expects a json array containing a batch of orders. Each order should have the same fields as those listed in the [New Order](#665d1346-78f2-4a6d-a723-2723cdfff7ed) endpoint. Please see that endpoint for individual order field names.

## Notes
Max order batch size: 100

Your warehouse may not pick up or use all of these fields. Any fields they do not use will be ignored.

### Array Response Fields
The `response` element of the API response will contain two sub-elements, `success` and `failed`. Each of these elements will contain an array of results. Below is the list of all possible fields that may be set for each. See sample response for full details.

|    Field    |    Data Type    |    Length    |    Description    |
|---------------|-----------------|--------------|---------------------------------------------------|
|    cust_ref    |    String    |  |    cust_ref of provided order, if available    |
|    cust_po_no    |    String    |  |    cust_po_no of provided order, if available    |
|    index_pos    |    Int    |  |   In `failed` array only: 0-index Position of order in input array. Used if input order does not contain a valid order number.   |
|    message    |    String    |  |    In `failed` array only: Error message when loading order    |

## Headers

- `Content-Type` string

## Request body `*/*`

- string

## Response `200`

OK

- object

---

[API](https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover.md) - [All operations](https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover/llms.txt) - [OpenAPI document](https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover/revisions/125e6deac675?raw)