---
title: "Obter PDF do boleto"
method: POST
path: "/brazil/boleto/onetime/download-pdf"
tags: ["Boleto"]
---

# Obter PDF do boleto

`POST /brazil/boleto/onetime/download-pdf`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/brazil/boleto/onetime/download-pdf`
- Auth: API key in header `x-api-key`

Devolve em base64 o PDF dos boletos das Transactions indicadas.

## Request body

- DownloadBoletoPdf
  - `id_transactions` string[], required

## Response `200`

PDF pronto, ou ainda em preparação quando `status` é `pending`.

- BoletoPdf: PDF do boleto, ou o aviso de que ainda está em preparação.
  - `base_64` string, nullable: Conteúdo do PDF em base64. Ausente enquanto o PDF não está pronto.
  - `filename` string, nullable: Nome sugerido para o arquivo. Ausente enquanto o PDF não está pronto.
  - `status` 'ready' | 'pending', required

## Other responses

- `204`: Nenhuma Transaction foi indicada.
- `422`: Validation Error

## Changes

- **2026-11-03** `a6ef070075b1`: 5 breaking, 5 info
  - request body became required
  - the request property `id_transactions` became required
  - removed the media type `text/plain` for the response with the status `204`
  - response property `base_64` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - …6 more

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/brazil/boleto/onetime/download-pdf/post.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)