---
title: "Import data files"
method: POST
path: "/v1/batches/data/import"
tags: ["Batches"]
---

# Import data files

`POST /v1/batches/data/import`

Import csv, xls and xlsx data files for: `Beta`<br/>
- trackers data
- orders data
- shipments data
- billing data (soon)<br/><br/>
**This operation will return a batch operation that you can poll to follow
the import progression.**

## Query parameters

- `data_file` string, binary
- `data_template` string
- `resource_type` 'billing' | 'order' | 'shipment' | 'trackers'

## Response `202`

- BatchOperation
  - `id` string — A unique identifier
  - `status` 'queued' | 'running' | 'failed' | 'completed' | 'completed_with_errors', required
  - `resource_type` 'orders' | 'shipments' | 'trackers' | 'billing', required
  - `resources` BatchObject[], required
    - `id` string — A unique identifier
    - `status` 'queued' | 'running' | 'failed' | 'completed' | 'completed_with_errors', required — The batch operation resource status
    - `errors` object, nullable — Resource processing errors
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `test_mode` boolean, required

## Other responses

- `400`
- `500`

---

[API](https://skmtc.dev/karrio/apis/karrio-api.md) · [All operations](https://skmtc.dev/karrio/apis/karrio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/karrio/karrio-api/revisions/76ab3b7c3a61/schema)