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

# Falhas batch de eventos de usuário

> Baixe relatórios CSV ou JSON com linhas de eventos de usuário que falharam em um job batch, incluindo número da linha, códigos de erro e validação.

## Endpoints

```
GET https://api.gu1.ai/batch-import/user-event-jobs/{jobId}/failures.csv
GET https://api.gu1.ai/batch-import/user-event-jobs/{jobId}/failures
```

* **`…/failures.csv`** → download CSV
* **`…/failures`** → JSON

## Autenticação e permissões

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

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

## Respostas HTTP

| Código | Quando             |
| ------ | ------------------ |
| `200`  | Job encontrado     |
| `401`  | Sem autenticação   |
| `403`  | Sem permissão      |
| `404`  | Job não encontrado |

## Colunas CSV

| Coluna    | Descrição                                                                              |
| --------- | -------------------------------------------------------------------------------------- |
| `row_key` | Id da linha fonte (p. ex. `row_5` = linha 5 do CSV)                                    |
| `code`    | Código estável — [catálogo](/pt/api-reference/bulk-imports/batch-import-failure-codes) |
| `error`   | Mensagem legível                                                                       |

## Resposta JSON

Mesmo envelope que [Falhas batch de transações](/pt/api-reference/bulk-imports/get-transaction-batch-failures), com `kind: user_event_batch`. O sample de `failures[]` (máx. 500) é hidratado a partir de `failures.csv` no S3 quando disponível; baixe o CSV para a lista completa.

```json theme={null}
{
  "success": true,
  "jobId": "…",
  "kind": "user_event_batch",
  "status": "completed",
  "totalItems": 50,
  "succeeded": 49,
  "failed": 1,
  "skipped": 0,
  "failures": [
    {
      "rowKey": "row_5",
      "code": "VALIDATION_ERROR",
      "message": "Campo obrigatório vazio"
    }
  ],
  "truncated": false,
  "failuresTotal": 1
}
```

Códigos típicos: `VALIDATION_ERROR`, `ENTITY_NOT_FOUND`, `PROCESSING_ERROR`.

Ver também: [Importar eventos](/pt/api-reference/bulk-imports/import-user-events), [Códigos de falha](/pt/api-reference/bulk-imports/batch-import-failure-codes).