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": {}
}
]
}