---
title: "Retrieve a batch operation"
method: GET
path: "/v1/batches/operations/{id}"
tags: ["Batches"]
---

# Retrieve a batch operation

`GET /v1/batches/operations/{id}`

Retrieve a batch operation. `Beta`

## Path parameters

- `id` string, required

## Response `200`

- 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

- `404`
- `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)