List charges with due date (COBV)

​

Retrieves charges with due date through parameters such as início, fim, cpf, cnpj and status. Bacen API Pix: consultar lista de cobranças com vencimento.

Query Parameters
  • inicio
    Type: string Format: date-time
    required

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • fim
    Type: string Format: date-time
    required

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • cpf
    Type: string
  • cnpj
    Type: string
  • status
    Type: string enum

    Status of a dynamic charge

    values
    • ATIVA
    • CONCLUIDA
    • REMOVIDA_PELO_USUARIO_RECEBEDOR
    • REMOVIDA_PELO_PSP
  • loteCobVId
    Type: string
  • lotecobvid
    Type: string
    deprecated

    Deprecated alias of loteCobVId (pre-Bacen wire name)

  • paginacao.paginaAtual
    Type: integer Format: int32

    Página corrente (0-based)

  • paginacao.itensPorPagina
    Type: integer Format: int32

    Itens por página

Responses
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/api/cobv
curl 'http://localhost:8080/api/cobv?inicio=&fim=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "parametros": {
    "inicio": "2026-08-14T09:00:00Z",
    "fim": "2026-08-14T18:00:00Z",
    "cpf": "string",
    "cnpj": "string",
    "locationPresente": true,
    "status": "ATIVA",
    "paginacao": {
      "paginaAtual": 1,
      "itensPorPagina": 1,
      "quantidadeDePaginas": 1,
      "quantidadeTotalDeItens": 1
    }
  },
  "cobs": [
    {
      "id": "string",
      "type": "STATIC",
      "txid": "string",
      "status": "ATIVA",
      "revisao": 1,
      "chave": "string",
      "calendario": {
        "criacao": "2026-09-16T19:14:18.674Z",
        "dataDeVencimento": "2026-09-16",
        "validadeAposVencimento": 1
      },
      "valor": {
        "original": "string",
        "multa": {
          "modalidade": 1,
          "valorPerc": "string"
        },
        "juros": {
          "modalidade": 1,
          "valorPerc": "string"
        },
        "abatimento": {
          "modalidade": 1,
          "valorPerc": "string"
        },
        "desconto": {
          "modalidade": 1,
          "descontoDataFixa": [
            {
              "data": "2026-09-16",
              "valorPerc": "string"
            }
          ],
          "valorPerc": "string"
        }
      },
      "devedor": {
        "cpf": "string",
        "cnpj": "string",
        "nome": "string",
        "email": "string",
        "logradouro": "string",
        "cidade": "string",
        "uf": "string",
        "cep": "string"
      },
      "recebedor": {
        "nome": "string",
        "cidade": "string",
        "taxId": "string",
        "logradouro": "string",
        "uf": "string",
        "cep": "string"
      },
      "solicitacaoPagador": "string",
      "infoAdicionais": [
        {
          "nome": "string",
          "valor": "string"
        }
      ],
      "loc": {
        "id": "string",
        "location": "string",
        "tipoCob": "cob",
        "criacao": "2026-09-16T19:14:18.674Z"
      },
      "location": "string",
      "pix": [
        {
          "endToEndId": "E1234567820260713123456789012345",
          "txid": "string",
          "valor": "100.0",
          "componentesValor": {
            "original": {
              "valor": "100.0"
            },
            "saque": {
              "valor": "20.0",
              "modalidadeAgente": "AGTEC",
              "prestadorDoServicoDeSaque": "string"
            },
            "troco": {
              "valor": "20.0",
              "modalidadeAgente": "AGTEC",
              "prestadorDoServicoDeSaque": "string"
            },
            "juros": {
              "valor": "100.0"
            },
            "multa": {
              "valor": "100.0"
            },
            "abatimento": {
              "valor": "100.0"
            },
            "desconto": {
              "valor": "100.0"
            }
          },
          "chave": "string",
          "horario": "2026-09-16T19:14:18.674Z",
          "infoPagador": "string",
          "devolucoes": [
            {
              "id": "devolucao001",
              "rtrId": "D1234567820260713123456789012345",
              "valor": "10.0",
              "natureza": "ORIGINAL",
              "descricao": "string",
              "horario": {
                "solicitacao": "2026-09-16T19:14:18.674Z",
                "liquidacao": "2026-09-16T19:14:18.674Z"
              },
              "status": "EM_PROCESSAMENTO",
              "motivo": "string"
            }
          ]
        }
      ],
      "pixCopiaECola": "string",
      "qrCodeImage": {
        "contentType": "string",
        "base64": "string"
      },
      "createdAt": "2026-09-16T19:14:18.674Z"
    }
  ]
}

Page of charges with due date