Listar cobranças

Lista as cobranças da conta, da mais recente para a mais antiga, com cursor.

GET /v2/ex/cobrancas

Escopo: cob.read.

GET /v2/ex/cobrancas?limite=2
→ 200
{
  "cobrancas": [
    {
      "txid": "COB02J1ZK7M9QW3ERT5TY6UI8O",
      "status": "ATIVA",
      "valor": "80.00",
      "devedor": { "cpf": "12345678909", "nome": "" },
      "criacao": "2026-09-18T12:00:01.768267Z",
      "expiracao": 900,
      "revisao": 0
    },
    {
      "txid": "COB01J1ZK7M9QW3ERT5TY6UI8O",
      "status": "ATIVA",
      "valor": "150.00",
      "devedor": { "cpf": "12345678909", "nome": "Fulano de Tal" },
      "criacao": "2026-09-18T12:00:00.767154Z",
      "expiracao": 900,
      "revisao": 0
    }
  ],
  "cursor": { "proximo": "MTc4OTcyMzIyMzc2NzE1NH5DT0Iw...", "temMais": true }
}

Parâmetro	Tipo	Obrigatório	Descrição
`limite`	inteiro	não	Itens por página, até 200. Padrão 50.
`cursor`	string	não	O `cursor.proximo` da página anterior.
`inicio`, `fim`	string	não	Intervalo de criação, RFC 3339.
`status`	string	não	Filtra por status: `ATIVA`, `CONCLUIDA`, `REMOVIDA_PELO_USUARIO_RECEBEDOR`, `REMOVIDA_PELO_PSP`.
`cpf`	string	não	Só as cobranças daquele pagador.
`subconta`	string	não	Só as cobranças daquela sub-conta.

A listagem não traz o pixCopiaECola. Para reenviar o QR, use Consultar cobrança.

GET /v2/cob?inicio=...&fim=... é a listagem no formato padrão do Banco Central, por intervalo de criação.

Erros #

Status	`title`	Quando
400	`cursor_invalido`	Cursor malformado.
400	`limite_invalido`	`limite` não é inteiro positivo.
400	`periodo_invalido`	`inicio` ou `fim` fora do RFC 3339.
400	`status_invalido`	`status` fora da lista.