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

# Baixar payload do job batch

> Baixa o payload.json processado guardado para um job de importação em lote (retomada/debug). Anexo autenticado — sem URL pública de object storage.

## Endpoint

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

Retorna o body JSON **processado** que a Gu1 guardou para **retomada/requeue** (linhas normalizadas + opções), como anexo. **Não** é o CSV/XLS original enviado pelo cliente — para isso use `GET /batch-import/jobs/{jobId}/source` quando existir `rawSourceS3Key`. A chave de object storage é resolvida no servidor e **nunca** é exposta como URL pública.

## Autenticação

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

Exige o mesmo gate de batch-import das demais rotas `/batch-import`, mais a permissão de **export** conforme o tipo:

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

## Respostas HTTP

| Status | Quando                                                              |
| ------ | ------------------------------------------------------------------- |
| `200`  | Bytes do payload (`Content-Type: application/json`)                 |
| `401`  | Não autenticado                                                     |
| `403`  | Sem permissão de export                                             |
| `404`  | Job desconhecido, ou payload não guardado (`PAYLOAD_NOT_AVAILABLE`) |
| `502`  | Não foi possível ler o objeto (`PAYLOAD_DOWNLOAD_FAILED`)           |

## Notas

* Disponível quando o metadata inclui `payloadS3Key` (ou um `sourceS3Key` legado que aponta para o `payload.json` deste job).
* Relacionado: arquivo original com `GET /batch-import/jobs/{jobId}/source` se houver `rawSourceS3Key`; falhas por linha com os endpoints `failures.csv` do tipo.

Veja também: [Consultar status do job batch](/pt/api-reference/bulk-imports/get-batch-job-status), [Falhas de job de transações](/pt/api-reference/bulk-imports/get-transaction-batch-failures).