> ## 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 histórico unificado de imports

> Histórico paginado e unificado de jobs de importação batch por tipo (entidades, transações, user events) — via API batch import da Gu1 para alto volume.

## Endpoint

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

## Overview

Lista jobs de importação batch da organização atual, mais recentes primeiro. Use para **listagens estilo dashboard** de imports recentes.

Para **polling de um job específico** após o upload, prefira [Consultar status do job batch](/pt/api-reference/bulk-imports/get-batch-job-status) — lookup direto por `jobId`, sem paginar o histórico.

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

## Autenticação

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

Requer pelo menos um de: **`transactions:create`**, **`entities:bulk_import`**, **`events:create`**.

## Query parameters

| Parâmetro                  | Default | Descrição                                                                                 |
| -------------------------- | ------- | ----------------------------------------------------------------------------------------- |
| `limit`                    | `50`    | Tamanho da página (máx. `100`)                                                            |
| `offset`                   | `0`     | Offset de paginação                                                                       |
| `kinds`                    | todos   | CSV: `entity_batch` (alias: `entity_automatic`), `transaction_batch`, `user_event_batch`  |
| `importStatus` ou `status` | todos   | CSV: `queued`, `running`, `completed`, `failed`, `cancelled`, `interrupted`, `cancelling` |
| `fileName`                 | —       | Correspondência parcial no nome do arquivo na metadata                                    |
| `jobId`                    | —       | Correspondência exata por job id (0 ou 1 linha)                                           |

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

| Campo            | Descrição                                                                                                      |
| ---------------- | -------------------------------------------------------------------------------------------------------------- |
| `id`             | Id interno da linha                                                                                            |
| `jobId`          | Id do job batch (usar em [Consultar status do job batch](/pt/api-reference/bulk-imports/get-batch-job-status)) |
| `kind`           | `entity_batch` (alias `entity_automatic`), `transaction_batch` ou `user_event_batch`                           |
| `status`         | Status atual                                                                                                   |
| `totalItems`     | Total de linhas/itens                                                                                          |
| `succeeded`      | Sucessos                                                                                                       |
| `failed`         | Falhas                                                                                                         |
| `skipped`        | Ignorados                                                                                                      |
| `metadata`       | Metadata (ex.: `fileName`)                                                                                     |
| `heartbeatAt`    | Último heartbeat (ISO 8601)                                                                                    |
| `leaseExpiresAt` | Expiração do lease (ISO 8601)                                                                                  |
| `workerError`    | Erro do worker truncado                                                                                        |
| `createdAt`      | Criação (ISO 8601)                                                                                             |
| `completedAt`    | Conclusão terminal (ISO 8601)                                                                                  |

Ver também: [Bulk imports overview](/pt/api-reference/bulk-imports/overview), [Consultar status do job batch](/pt/api-reference/bulk-imports/get-batch-job-status).