---
title: "Criar Lote"
method: POST
path: "/v1/bank_billet_batches"
tags: ["Lotes"]
---

# Criar Lote

`POST /v1/bank_billet_batches`

## Request

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

Criar Lote.

## Headers

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

## Request body

- BankBilletBatchCreateObject
  - `name` string, nullable, required: Nome do lote.
  - `bank_billet_ids` string, nullable: IDs dos [Boletos](/reference/post_v1-bank-billets-1) separados por vírgula.

## Response `201`

Lote criado com sucesso

- BankBilletBatchObject
  - `id` integer: ID do lote
  - `name` string, nullable, required: Nome do lote.
  - `bank_billet_ids` integer[], nullable: IDs dos [Boletos](/reference/post_v1-bank-billets-1).
  - `created_at` string, date-time, nullable: Data e hora de criação.
  - `updated_at` string, date-time, nullable: Data e hora da última atualização.

## Other responses

- `401`: Falha de autenticação. Token inválido
- `403`: Falha de permissão. Você não tem o Scope obrigatório para essa chamada.
- `422`: Dados inválidos

---

[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)