Bulk Import Orders

Creates multiple orders in a single request for efficient batch processing.

Use Cases

  • Migrating orders from another system
  • Processing batch uploads from sales channels
  • Syncing orders from offline sources

Processing

Each order in the batch is processed independently:

  • Valid orders are created successfully
  • Invalid orders return error details
  • Processing continues even if some orders fail

Limits

  • Maximum 20 orders per request
  • Each order follows the same validation as single order creation

Response

Returns a list of results for each order:

  • Successfully created orders include the full order object
  • Failed orders include error details for troubleshooting
SecurityOAuth2-Production or OAuth2-Demo
Request
header Parameters
x-api-key
required
string

Your Carriyo API key for authentication.

tenant-id
required
string

Your unique tenant identifier in Carriyo.

Content-Type
string
Default: application/json
Request Body schema: application/json
required
Array of objects (Create Order Request)

Array of orders to create (maximum 20).

Responses
200

Bulk import processed.

400

Invalid request payload.

post/orders/bulk/import
Request samples
application/json
{
  • "order_requests": [
    ]
}
Response samples
application/json
[
  • {
    }
]