> ## 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.

# Listar historial unificado de imports

> Historial paginado y unificado de jobs de importación batch por tipo (entidades, transacciones, user events) — vía la API batch import de Gu1 para alto volumen.

## Endpoint

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

## Overview

Lista jobs de importación batch de la organización actual, más recientes primero. Usen esto para **listados estilo dashboard** de imports recientes.

Para **polling de un job puntual** después del upload, preferir [Consultar estado de job batch](/es/api-reference/bulk-imports/get-batch-job-status) — lookup directo por `jobId`, sin paginar el histórico.

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

## Autenticación

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

Requiere al menos uno de: **`transactions:create`**, **`entities:bulk_import`**, **`events:create`**.

## Query parameters

| Parámetro                 | Default | Descripción                                                                               |
| ------------------------- | ------- | ----------------------------------------------------------------------------------------- |
| `limit`                   | `50`    | Tamaño de página (máx. `100`)                                                             |
| `offset`                  | `0`     | Offset de paginación                                                                      |
| `kinds`                   | todos   | CSV: `entity_batch` (alias: `entity_automatic`), `transaction_batch`, `user_event_batch`  |
| `importStatus` o `status` | todos   | CSV: `queued`, `running`, `completed`, `failed`, `cancelled`, `interrupted`, `cancelling` |
| `fileName`                | —       | Coincidencia parcial sobre nombre de archivo en metadata                                  |
| `jobId`                   | —       | Coincidencia exacta por job id (0 o 1 fila)                                               |

## Campos de cada job en `jobs[]`

| Campo            | Descripción                                                                                                     |
| ---------------- | --------------------------------------------------------------------------------------------------------------- |
| `id`             | Id interno de fila                                                                                              |
| `jobId`          | Id del job batch (usar en [Consultar estado de job batch](/es/api-reference/bulk-imports/get-batch-job-status)) |
| `kind`           | `entity_batch` (alias `entity_automatic`), `transaction_batch` o `user_event_batch`                             |
| `status`         | Estado actual                                                                                                   |
| `totalItems`     | Total de filas/ítems                                                                                            |
| `succeeded`      | Éxitos                                                                                                          |
| `failed`         | Fallos                                                                                                          |
| `skipped`        | Omitidos                                                                                                        |
| `metadata`       | Metadata (p. ej. `fileName`)                                                                                    |
| `heartbeatAt`    | Último heartbeat (ISO 8601)                                                                                     |
| `leaseExpiresAt` | Expiración de lease (ISO 8601)                                                                                  |
| `workerError`    | Error del worker truncado                                                                                       |
| `createdAt`      | Creación (ISO 8601)                                                                                             |
| `completedAt`    | Finalización terminal (ISO 8601)                                                                                |

Ver también: [Bulk imports overview](/es/api-reference/bulk-imports/overview), [Consultar estado de job batch](/es/api-reference/bulk-imports/get-batch-job-status).