---
title: "Retrieve a catalog variance batch"
method: GET
path: "/catalog/variance-batches/{id}"
tags: ["catalog"]
---

# Retrieve a catalog variance batch

`GET /catalog/variance-batches/{id}`

Returns a single draft or exported Catalog Variance Manager batch by its ctb_xxx ID.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required
- `X-Api-Key` string, required
- `X-API-Version` string

## Response `200`

Successful response with the batch

- CatalogVarianceBatchObject — A Catalog Variance Manager batch, draft or exported.
  - `id` string, required — Unique batch identifier (prefixed with ctb_)
  - `ottimate_company_id` integer, required — Company ID this batch belongs to
  - `batch_number` integer, required — Sequential batch number within the company
  - `export_status` 'draft' | 'exported', required — 'draft' when exported_at is null, 'exported' once exported_at is set
  - `exported_at` string, date-time, nullable — Timestamp when the batch was exported. Null for draft batches.
  - `exported_at_utc` string, date-time, nullable — UTC equivalent of exported_at. ISO 8601 with Z suffix, e.g. "2025-05-20T15:17:35.652584Z". Null for draft batches.
  - `costbatch_payload` CostBatchPayload, required — Costbatch payload in the same shape as the Pyxis /costbatch endpoint.
    - `description` string — Human-readable batch description, e.g. 'Catalog Batch 42'
    - `zone` string — Geographical zone for this batch
    - `import_def_id` integer — Pyxis import definition ID from the company token. Defaults to 0 if no Pyxis token is configured.
    - `external_batch_number` string — String representation of the batch number
    - `start_datetime` string, date-time — Start date for this batch's price updates
    - `catalog_items` CatalogItemPayload[] — List of catalog items with updated costs

## Other responses

- `403` — Forbidden - Access denied or insufficient permissions
- `404` — Not found - Resource does not exist

## Changes

- **2026-08-19** `c0b5cf6c7a72` — 1 info
  - endpoint added
- **2026-08-17** `c231509a03cf` — 1 breaking
  - api path removed without deprecation
- **2026-08-13** `1f089f3e34d9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ottimate/apis/api-reference/changes/catalog/variance-batches/:id/get.md)

---

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