---
title: "Retrieve an import batch"
method: GET
path: "/imports/{id}"
tags: ["Imports"]
---

# Retrieve an import batch

`GET /imports/{id}`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/imports/{id}`
- Auth: HTTP bearer

Returns one import batch including live status, row errors, and the proposed mapping.

## Path parameters

- `id` string, required: The import batch ID.

## Response `200`

Successful response.

- ImportDetail
  - `id` string, required
  - `object` 'import', required
  - `filename` string, required
  - `sourceFormat` string, required
  - `status` string, required
  - `discoveryStatus` string, nullable, required
  - `totalRows` number, required
  - `processedRows` number, required
  - `createdCount` number, required
  - `updatedCount` number, required
  - `skippedCount` number, required
  - `errorCount` number, required
  - `startedAt` string, nullable, required
  - `completedAt` string, nullable, required
  - `createdAt` string, required
  - `errors` ImportBatchError[], required
    - `rowIndex` number, required
    - `code` string, required
    - `message` string, required
  - `proposedMapping` object, nullable, required: Typed, operator-reviewable mapping state. Fingerprints, cache identity, AI provenance, and extraction machinery are private.
    - `fieldMappings` object[], required
      - `sourceColumn` string, required
      - `targetField` string, required
      - `confidence` number, required
      - `notes` string
    - `defaults` object, required
      - `employmentType` string
      - `remoteOption` string
      - `currency` string
      - `descriptionFormat` string
    - `valueTransforms` object[], required
      - `sourceColumn` string, required
      - `targetField` string, required
      - `map` object, required
      - `fallback` string
    - `unmappedSourceColumns` string[], required
    - `missingRequiredTargets` string[], required
    - `warnings` string[], required

## Other responses

- `404`: Import not found.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `404` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/imports/:id/get.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)