---
title: "Issue Boleto"
method: POST
path: "/boletos"
tags: ["Boleto Management"]
---

# Issue Boleto

`POST /boletos`

## Request body

- CreateBoleto — Request with information to create a boleto
  - `boletoConnectionId` string, uuid, required — Primary identifier of the boleto connection
  - `boleto` object, required
    - `seuNumero` string, required — Your identifier for this boleto
    - `amount` number, required — Boleto amount
    - `dueDate` string, date-time, required — Due date for the boleto. Must be today or in the future.
    - `payer` object, required
      - `taxNumber` string, required — Payer tax number (CPF/CNPJ)
      - `name` string, required — Payer name
      - `addressStreet` string — Payer street address
      - `addressCity` string — Payer city
      - `addressState` string, required — Payer state
      - `addressZipCode` string, required — Payer ZIP code
    - `fine` object — Fine information for late payment
      - `value` number, required — Fine value
      - `type` 'PERCENTAGE' | 'FIXED', required — Type of fine calculation
    - `interest` object — Interest information for late payment
      - `value` number, required — Interest value
      - `type` 'PERCENTAGE', required — Type of interest calculation

## Response `200`

Boleto created successfully

- IssuedBoleto — Response with information related to an issued boleto
  - `id` string, required — Primary identifier
  - `amount` number, required — Boleto amount
  - `status` 'OPEN' | 'PAID' | 'OVERDUE' | 'CANCELLED' | 'PROTESTED', required — Current status of the boleto. - `OPEN`: the boleto has been issued and is awaiting payment. - `PAID`: the boleto has been paid (see `paidAt`, `amountPaid`, `paymentOrigin`). - `OVERDUE`: the due date has passed and the boleto has not been paid. - `CANCELLED`: the boleto was canceled by the issuer. - `PROTESTED`: the boleto was sent to a protesto/credit-bureau process.
  - `seuNumero` string, required — Your identifier for this boleto
  - `dueDate` string, date-time, required — Due date of the boleto
  - `payer` object, required
    - `taxNumber` string, required — Payer tax number (CPF/CNPJ)
    - `personType` string — Type of person (individual or business)
    - `name` string, required — Payer name
    - `addressStreet` string — Payer street address
    - `addressNumber` string — Payer address number
    - `addressComplement` string — Additional address information
    - `addressNeighborhood` string — Payer neighborhood
    - `addressCity` string — Payer city
    - `addressState` string, required — Payer state
    - `addressZipCode` string, required — Payer ZIP code
    - `email` string — Payer email
    - `ddd` string — Payer area code
    - `phoneNumber` string — Payer phone number
  - `pixQr` string — PIX QR code for payment
  - `digitableLine` string, required — Boleto digitable line
  - `nossoNumero` string — Bank's internal identifier for the boleto
  - `barcode` string, required — Boleto barcode
  - `boletoConnectionId` string, uuid, required — ID of the boleto connection used to create this boleto
  - `createdAt` string, date-time, required — Date when the boleto was created
  - `amountPaid` number, nullable — Amount that was paid for this boleto
  - `paymentOrigin` 'PIX' | 'BOLETO', nullable — Origin of the payment when the boleto is paid
  - `fine` object, nullable — Fine information for late payment
    - `value` number — Fine value
    - `type` 'PERCENTAGE' | 'FIXED' — Type of fine calculation
  - `interest` object — Interest information for late payment
    - `value` number — Interest value
    - `type` 'PERCENTAGE' — Type of interest calculation
  - `paidAt` string, date-time — Date when the boleto was paid

---

[API](https://skmtc.dev/pluggy/apis/pluggy-api.md) · [All operations](https://skmtc.dev/pluggy/apis/pluggy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pluggy/pluggy-api/revisions/75e87ec7f9cd/schema)