---
title: "Create Boletos"
method: POST
path: "/v2/boleto"
tags: ["Boleto"]
---

# Create Boletos

`POST /v2/boleto`

## Request

- Base URL: `https://api.starkbank.com`
- URL: `https://api.starkbank.com/v2/boleto`
- Auth: API key in header `Digital-Signature`

This is how you create a new list of boletos. You can create up to 100 boletos per request. In case a boleto is paid after its due date and there is fine or interest, its amount will be updated with the paid amount. The same is valid if the boleto is paid with a discount.

## Request body

- object
  - `amount` integer, required: A positive integer that represents the amount in cents to be charged, with a minimum of 200 (R$2.00). Example: 1234 (R$12.34).
  - `city` string, required: Customer city name. Example: "São Paulo".
  - `district` string, required: Customer district name. Example: "Itaim Bibi".
  - `name` string, required: Customer full name. Example: "Anthony Edward Stark".
  - `stateCode` string, required: Customer state code. Example: "SP".
  - `streetLine1` string, required: Customer street address. Example: "Av. Faria Lima, 1844".
  - `streetLine2` string, required: Customer street address complement. Example: "CJ 13".
  - `taxId` string, required: Customer CPF (11 digits formatted or unformatted) or CNPJ (14 digits formatted or unformatted). Example: 012.345.678-90.
  - `zipCode` string, required: Customer zip code. Example: 01500-000.
  - `descriptions` object[]: List of up to 15 descriptions containing information to help the customer understand why he is being charged. You can add text and amount to create a table or you can just add text. When generating PDFs, if the 'booklet' layout is selected, only the text field of the first description will be considered and it will be used to fill the installment cell in the PDF. Example: [{"text": "Explaining first part of the value", "amount": 20000}, {"text": "More text to explaining something to the customer"}]
  - `discounts` object[]: List of up to 2 discounts specifying the discount percentage and the limit date up to when the discount is valid. Example: [{"percentage": 5, "date": "2020-04-01"}, {"percentage": 3.5, "date": "2020-04-02"}]
  - `due` string, date-time: Due date of the boleto. Example: 2020-06-27. The default value is set to two days after creation date.
  - `fine` number, float: Percentage of the boleto amount charged if customer pays after the due date. Default value = 2.00 (2%).
  - `interest` number, float: Monthly interest, in percentage, charged if customer pays after the due date. Default value = 1.00 (1%).
  - `overdueLimit` string: Number of days after due date after which the boleto will no longer be payable. 0<=overdueLimit<=59. Default value=59.
  - `receiverName` string: Name of the credit receiver (Sacador Avalista). If none is informed, workspace owner name will be used. If informed, receiverTaxId must also be informed.
  - `receiverTaxId` string: Tax ID (CPF/CNPJ) of the credit receiver (Sacador Avalista). If none is informed, workspace owner tax ID will be used. If informed, receiverName must also be informed.
  - `splits` object[]: Array of Split objects to indicate payment receivers. Example: [{"receiverId": "5742447426535424", "amount": 100}, {"receiverId": "5743243941642240", "amount": 200}]
  - `tags` string[]: Filter entities that contain the specified tags.

## Response `200`

Successful operation

- object

## Other responses

- `400`: Client error
- `500`: Server error

---

[API](https://skmtc.dev/starkbank/apis/stark-bank-api.md) - [All operations](https://skmtc.dev/starkbank/apis/stark-bank-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starkbank/apis/stark-bank-api/revisions/aeff5068a5da?raw)