---
title: "List import batches"
method: GET
path: "/imports"
tags: ["Imports"]
---

# List import batches

`GET /imports`

## Request

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

Returns your import batches, most recent first. Filter by status and creation-time range.

## Query parameters

- `cursor` string
- `limit` integer
- `status` 'pending' | 'processing' | 'completed' | 'partial' | 'failed': Filter by batch status (single value).
- `from` string, date-time: Only batches created at or after this ISO 8601 timestamp.
- `to` string, date-time: Only batches created at or before this ISO 8601 timestamp.

## Response `200`

Successful response.

- object
  - `object` 'list', required
  - `url` string, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required
  - `data` Import[], required
    - `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

## Other responses

- `400`: The pagination cursor or query is invalid.

## Changes

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

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/imports/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)