---
title: "Export a catalog variance batch (local only)"
method: POST
path: "/catalog/variance-batches/{id}/export"
tags: ["catalog"]
---

# Export a catalog variance batch (local only)

`POST /catalog/variance-batches/{id}/export`

Marks the batch as exported without sending data to any external system. Sets exported_at to the current timestamp and api_status to success. Returns the exported batch with its costbatch_payload. Returns 400 if the batch is already exported.

## Path parameters

- `id` string, required

## Headers

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

## Response `200`

Batch successfully marked as exported

- CatalogVarianceBatchObject — An exported Catalog Variance Manager batch.
  - `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` 'exported', required — Always 'exported' — non-exported batches are never returned by this API
  - `exported_at` string, date-time, required — Timestamp when the batch was exported
  - `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".
  - `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

- `400` — Bad request - Invalid parameters or request format
- `403` — Forbidden - Access denied or insufficient permissions
- `404` — Not found - Resource does not exist

---

[API](https://skmtc.net/ottimate/apis/api-reference.md) · [All operations](https://skmtc.net/ottimate/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ottimate/api-reference/versions/3b3756010473/schema)