# PDF do boleto
`GET /v1/charges/:chargeId/boleto.pdf`
**Área:** Cobranças

Baixa o PDF do boleto. **Rota pública: não envie `Authorization`.** É o endereço que a API devolve em `pdfUrl` ao criar um boleto, e pode ser aberto direto pelo pagador.

Responde o binário do PDF com `Content-Type: application/pdf`, exibido no navegador. Para forçar o download, acrescente `?download=1`.

O arquivo é gerado na criação da cobrança, mas não depende disso: se ele não estiver armazenado, a rota o regenera na hora e devolve normalmente. Só responde `404 BOLETO_PDF_NOT_AVAILABLE` quando nem a regeneração é possível.

Cobrança que não é boleto responde `400 CHARGE_NOT_BOLETO`.

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `chargeId` | **sim** | Identificador devolvido na criação da cobrança |

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `download` | não | 1 ou true força o download em vez de exibir no navegador |

### Resposta 400: 400 Cobrança não é boleto

```json
{
  "error": {
    "message": "Cobranca nao e do tipo boleto",
    "code": "CHARGE_NOT_BOLETO",
    "details": null,
    "timestamp": "2026-09-14T18:20:00.000Z"
  }
}
```

### Resposta 404: 404 PDF indisponível

```json
{
  "error": {
    "message": "PDF do boleto nao disponivel",
    "code": "BOLETO_PDF_NOT_AVAILABLE",
    "details": null,
    "timestamp": "2026-09-14T18:20:00.000Z"
  }
}
```

---
Página: https://docs.validapay.com.br/referencia/get-pdf-do-boleto
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json