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

# Descargar payload del job batch

> Descarga el payload.json procesado guardado para un job de importación masiva (reanudación/debug). Adjunto autenticado — sin URL pública de object storage.

## Endpoint

```
GET https://api.gu1.ai/batch-import/jobs/{jobId}/payload
```

Devuelve el body JSON **procesado** que Gu1 guardó para **reanudación/requeue** (filas normalizadas + opciones), como adjunto. **No** es el CSV/XLS original que subió el cliente — para eso usá `GET /batch-import/jobs/{jobId}/source` cuando exista `rawSourceS3Key`. La clave de object storage se resuelve en el servidor y **nunca** se expone como URL pública.

## Autenticación

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

Requiere el mismo gate de batch-import que el resto de `/batch-import`, más el permiso de **export** según el tipo:

| Tipo de job                               | Permiso               |
| ----------------------------------------- | --------------------- |
| `transaction_batch`                       | `transactions:export` |
| `user_event_batch`                        | `events:export`       |
| `entity_batch` (alias `entity_automatic`) | `entities:export`     |

## Respuestas HTTP

| Status | Cuándo                                                           |
| ------ | ---------------------------------------------------------------- |
| `200`  | Bytes del payload (`Content-Type: application/json`)             |
| `401`  | No autenticado                                                   |
| `403`  | Sin permiso de export                                            |
| `404`  | Job desconocido, o payload no guardado (`PAYLOAD_NOT_AVAILABLE`) |
| `502`  | No se pudo leer el objeto (`PAYLOAD_DOWNLOAD_FAILED`)            |

## Notas

* Disponible cuando el metadata incluye `payloadS3Key` (o un `sourceS3Key` legacy que apunta al `payload.json` de este job).
* Relacionado: archivo original con `GET /batch-import/jobs/{jobId}/source` si hay `rawSourceS3Key`; fallos por fila con los endpoints `failures.csv` del tipo.

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