> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List unified import history

> Paginated history of batch import jobs across kinds — via the gu1 batch import API for high-volume data loading, with examples for list unified history use.

## Endpoint

```
GET https://api.gu1.ai/batch-import/unified-history
```

## Overview

Lists batch import jobs for the current organization, newest first. Use this for **dashboard-style listing** of recent imports.

For **polling a single job** after upload, prefer [Get batch job status](/en/api-reference/bulk-imports/get-batch-job-status) — direct lookup by `jobId`, no pagination scan.

**Response:** `{ success: true, jobs: [...], total, limit, offset }`.

## Authentication

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

Requires at least one of: **`transactions:create`**, **`entities:bulk_import`**, **`events:create`**.

## Query parameters

| Parameter                  | Default | Description                                                                                           |
| -------------------------- | ------- | ----------------------------------------------------------------------------------------------------- |
| `limit`                    | `50`    | Page size (max `100`)                                                                                 |
| `offset`                   | `0`     | Pagination offset                                                                                     |
| `kinds`                    | all     | Comma-separated: `entity_batch` (alias: `entity_automatic`), `transaction_batch`, `user_event_batch`  |
| `importStatus` or `status` | all     | Comma-separated: `queued`, `running`, `completed`, `failed`, `cancelled`, `interrupted`, `cancelling` |
| `fileName`                 | —       | Partial match on file name in job metadata                                                            |
| `jobId`                    | —       | Exact match on job id (returns 0 or 1 row)                                                            |

## Job object fields

Each entry in `jobs[]`:

| Field            | Description                                                                                        |
| ---------------- | -------------------------------------------------------------------------------------------------- |
| `id`             | Internal row id                                                                                    |
| `jobId`          | Batch job id (use for [Get batch job status](/en/api-reference/bulk-imports/get-batch-job-status)) |
| `kind`           | `entity_batch` (alias `entity_automatic`), `transaction_batch`, or `user_event_batch`              |
| `status`         | Current job status                                                                                 |
| `totalItems`     | Total rows/items                                                                                   |
| `succeeded`      | Success count                                                                                      |
| `failed`         | Failure count                                                                                      |
| `skipped`        | Skipped count                                                                                      |
| `metadata`       | Job metadata (e.g. `fileName`)                                                                     |
| `heartbeatAt`    | Last worker heartbeat (ISO 8601)                                                                   |
| `leaseExpiresAt` | Worker lease expiry (ISO 8601)                                                                     |
| `workerError`    | Truncated worker error when failed                                                                 |
| `createdAt`      | Creation time (ISO 8601)                                                                           |
| `completedAt`    | Completion time when terminal (ISO 8601)                                                           |

See also: [Bulk imports overview](/en/api-reference/bulk-imports/overview), [Get batch job status](/en/api-reference/bulk-imports/get-batch-job-status).