---
title: "Cancelar o Boleto"
method: PUT
path: "/v1/bank_billets/{id}/cancel"
tags: ["Boletos"]
---

# Cancelar o Boleto

`PUT /v1/bank_billets/{id}/cancel`

## Request

- Base URL: `https://api-sandbox.kobana.com.br`
- URL: `https://api-sandbox.kobana.com.br/v1/bank_billets/{id}/cancel`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/kobana/apis/cobran-as/docs/v1/bank_billets/:id/cancel/put.ts> (a function with typed inputs; its response is checked against the schema)

Cancela boletos nos status de Aberto(opened) ou Vencido(overdue)

## Path parameters

- `id` string, required

## Headers

- `User-Agent` string
- `X-Idempotency-Key` string

## Request body

- BankBilletCancelObject
  - `cancellation_reason` 1 | 2 | 3 | 4 | 5, nullable: Motivo do cancelamento: * `1` Outro * `2` Fraude * `3` Óbito * `4` Erro operacional * `5` Quitação paga

## Response `204`

Boleto cancelado

## Other responses

- `404`: Boleto não encontrado
- `422`: Boleto não pode ser cancelado

---

[API](https://skmtc.dev/kobana/apis/cobran-as.md) - [All operations](https://skmtc.dev/kobana/apis/cobran-as/llms.txt) - [OpenAPI document](https://skmtc.dev/kobana/apis/cobran-as/revisions/728c362ec4d7?raw)