List batches of charges with due date (Bacen /lotecobv)

​

Retrieves the list of batches of charges with due date. Bacen API Pix: consultar lotes 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

  • 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/lotecobv
curl 'http://localhost:8080/api/lotecobv?inicio=&fim=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "parametros": {
    "inicio": "2026-09-16T19:14:18.843Z",
    "fim": "2026-09-16T19:14:18.843Z",
    "paginacao": {
      "paginaAtual": 1,
      "itensPorPagina": 1,
      "quantidadeDePaginas": 1,
      "quantidadeTotalDeItens": 1
    }
  },
  "lotes": [
    {
      "id": "string",
      "descricao": "string",
      "criacao": "2026-09-16T19:14:18.843Z",
      "cobsv": [
        {
          "criacao": "2026-09-16T19:14:18.843Z",
          "txid": "string",
          "status": "EM_PROCESSAMENTO",
          "problema": {
            "type": "https://pix.bcb.gov.br/api/v2/error/CobVOperacaoInvalida",
            "title": "Cobrança inválida.",
            "status": 400,
            "detail": "string",
            "correlationId": "string",
            "violacoes": [
              {
                "razao": "string",
                "propriedade": "cob.chave",
                "valor": "061996671234"
              }
            ]
          }
        }
      ]
    }
  ]
}

Page of COBV batches