Pular para o conteúdo
Vintém

Listar cobranças imediatas

GET
/cob
curl --request GET \
  --url 'http://localhost:8080/cob?inicio=2026-04-15T12%3A00%3A00Z&fim=2026-04-15T12%3A00%3A00Z&status=ATIVA&paginacao.paginaAtual=0&paginacao.itensPorPagina=100' \
  --header 'Authorization: Bearer <token>'

Authorizations

Seção intitulada “Authorizations”

Parameters

Seção intitulada “Parameters”

Query Parameters

Seção intitulada “Query Parameters”
inicio
required
string format: date-time
fim
required
string format: date-time
cpf
string
/^\d{11}$/
cnpj

Aceita o CNPJ alfanumérico.

string
/^[0-9A-Z]{14}$/
locationPresente
boolean
status
string
Allowed values: ATIVA CONCLUIDA REMOVIDA_PELO_USUARIO_RECEBEDOR REMOVIDA_PELO_PSP
paginacao.paginaAtual
integer format: int32
0
paginacao.itensPorPagina
integer format: int32
default: 100 >= 1 <= 1000

Responses

Seção intitulada “Responses”

200

Seção intitulada “200”

Página de cobranças.

Media typeapplication/json
object
parametros
required
object
inicio
required
string format: date-time
fim
required
string format: date-time
cpf
string
/^\d{11}$/
cnpj

Aceita o CNPJ alfanumérico.

string
/^[0-9A-Z]{14}$/
locationPresente
boolean
status
string
paginacao
required
object
paginaAtual
required
integer
itensPorPagina
required
integer
>= 1
quantidadeDePaginas
required
integer
>= 1
quantidadeTotalDeItens
required
integer
cobs
required
Array
object
calendario
required
object
criacao
required
string format: date-time
expiracao
required
integer format: int32
txid
required
string
/^[a-zA-Z0-9]{26,35}$/
revisao
required

Começa em 0 e cresce de 1 em 1 a cada alteração.

integer format: int32
devedor

Pessoa física (cpf) ou jurídica (cnpj). Informe um dos dois.

object
cpf
string
/^\d{11}$/
cnpj

Aceita o CNPJ alfanumérico.

string
/^[0-9A-Z]{14}$/
nome
required
string
<= 200 characters
loc
object
id
required
integer format: int64
location
string
tipoCob
string
Allowed values: cob cobv
criacao
string format: date-time
location
string
status
required
string
Allowed values: ATIVA CONCLUIDA REMOVIDA_PELO_USUARIO_RECEBEDOR REMOVIDA_PELO_PSP
valor
required
object
original
required
string
/^\d{1,10}\.\d{2}$/
modalidadeAlteracao

1 permite ao pagador alterar o valor.

integer format: int32
0 <= 1
chave
required

Chave Pix do recebedor (telefone, e-mail, CPF/CNPJ ou EVP).

string
<= 77 characters
solicitacaoPagador
string
infoAdicionais
Array<object>
object
nome
required
string
<= 50 characters
valor
required
string
<= 200 characters
pixCopiaECola
string
<= 512 characters
expirada

Extensão do Vintém. Na spec a cob continua ATIVA depois de expirar; este campo poupa o cálculo (RN-13).

boolean
pix
Array<object>
object
endToEndId
required
string
/^[a-zA-Z0-9]{32}$/
txid
string
valor
required
string
/^\d{1,10}\.\d{2}$/
chave

Chave Pix do recebedor (telefone, e-mail, CPF/CNPJ ou EVP).

string
<= 77 characters
horario
required
string format: date-time
infoPagador
string
<= 140 characters

Example 

{
  "cobs": [
    {
      "loc": {
        "tipoCob": "cob"
      },
      "status": "ATIVA",
      "valor": {
        "original": "10.50",
        "modalidadeAlteracao": 0
      },
      "pix": [
        {
          "valor": "10.50"
        }
      ]
    }
  ]
}

400

Seção intitulada “400”

Requisição fora do formato ou violando uma regra de negócio.

Media typeapplication/problem+json

Erro no formato da spec do BCB (RFC 7807).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
correlationId
string
violacoes
Array<object>
object
razao
string
propriedade
string
valor
string

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "correlationId": "example",
  "violacoes": [
    {
      "razao": "example",
      "propriedade": "example",
      "valor": "example"
    }
  ]
}

401

Seção intitulada “401”

API key ausente ou inválida.

Media typeapplication/problem+json

Erro no formato da spec do BCB (RFC 7807).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
correlationId
string
violacoes
Array<object>
object
razao
string
propriedade
string
valor
string

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "correlationId": "example",
  "violacoes": [
    {
      "razao": "example",
      "propriedade": "example",
      "valor": "example"
    }
  ]
}

403

Seção intitulada “403”

A API key não tem o escopo necessário.

Media typeapplication/problem+json

Erro no formato da spec do BCB (RFC 7807).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
correlationId
string
violacoes
Array<object>
object
razao
string
propriedade
string
valor
string

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "correlationId": "example",
  "violacoes": [
    {
      "razao": "example",
      "propriedade": "example",
      "valor": "example"
    }
  ]
}

default

Seção intitulada “default”

Qualquer outro erro, sempre como Problema. Os mais comuns: 502 quando o banco recusa ou falha (PSPIndisponivel) e 500 para erro interno.

Media typeapplication/problem+json

Erro no formato da spec do BCB (RFC 7807).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
string
correlationId
string
violacoes
Array<object>
object
razao
string
propriedade
string
valor
string

Example generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "correlationId": "example",
  "violacoes": [
    {
      "razao": "example",
      "propriedade": "example",
      "valor": "example"
    }
  ]
}