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

# Fallos batch de eventos de usuario

> Descarga reportes CSV o JSON con filas fallidas de un job batch de eventos de usuario, incluyendo número de fila, códigos de error y mensajes de validación.

## 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`** → descarga CSV
* **`…/failures`** → JSON

## Autenticación y permisos

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

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

## Respuestas HTTP

| Código | Cuándo            |
| ------ | ----------------- |
| `200`  | Job encontrado    |
| `401`  | Sin autenticación |
| `403`  | Sin permiso       |
| `404`  | Job no encontrado |

## Columnas CSV

| Columna   | Descripción                                                                            |
| --------- | -------------------------------------------------------------------------------------- |
| `row_key` | Id de fila fuente (p. ej. `row_5` = línea 5 del CSV)                                   |
| `code`    | Código estable — [catálogo](/es/api-reference/bulk-imports/batch-import-failure-codes) |
| `error`   | Mensaje legible                                                                        |

## Respuesta JSON

Mismo sobre que [Fallos batch de transacciones](/es/api-reference/bulk-imports/get-transaction-batch-failures), con `kind: user_event_batch`. El sample de `failures[]` (máx. 500) se hidrata desde `failures.csv` en S3 cuando existe; descargá el CSV para el listado completo.

```json theme={null}
{
  "success": true,
  "jobId": "…",
  "kind": "user_event_batch",
  "status": "completed",
  "failures": [
    {
      "rowKey": "row_5",
      "code": "VALIDATION_ERROR",
      "message": "Campo requerido vacío"
    }
  ],
  "truncated": false,
  "failuresTotal": 1
}
```

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

Ver también: [Importar eventos](/es/api-reference/bulk-imports/import-user-events), [Códigos de fallo](/es/api-reference/bulk-imports/batch-import-failure-codes).