Import data files
POST/v1/batches/data/import
Import csv, xls and xlsx data files for: Beta
- trackers data
- orders data
- shipments data
- billing data (soon)
This operation will return a batch operation that you can poll to follow the import progression.
Request
Query Parameters
A data template slug to use for the import.
When nothing is specified, the system default headers are expected.
Possible values: [billing
, order
, shipment
, trackers
]
The type of the resource to import
- multipart/form-data
Body
Responses
- 202
- 400
- 500
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
A unique identifier
Possible values: [queued
, running
, failed
, completed
, completed_with_errors
]
Possible values: [orders
, shipments
, trackers
, billing
]
resources
object[]
required
A unique identifier
Possible values: [queued
, running
, failed
, completed
, completed_with_errors
]
The batch operation resource status
errors
object
nullable
Resource processing errors
Resource processing errors
{
"id": "string",
"status": "queued",
"resource_type": "orders",
"resources": [
{
"id": "string",
"status": "queued",
"errors": {}
}
],
"created_at": "2024-07-29T15:51:28.071Z",
"updated_at": "2024-07-29T15:51:28.071Z",
"test_mode": true
}
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
errors
object[]
The list of API errors
The error or warning message
The message code
details
object
any additional details
any additional details
{
"errors": [
{
"message": "string",
"code": "string",
"details": {}
}
]
}
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
errors
object[]
The list of API errors
The error or warning message
The message code
details
object
any additional details
any additional details
{
"errors": [
{
"message": "string",
"code": "string",
"details": {}
}
]
}