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, de 1 a 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: `inicio` entra, `fim` não entra. Para um dia inteiro, use `fim` com a meia-noite do dia seguinte.
`status`	string	não	Filtra por status: `ATIVA`, `CONCLUIDA`, `REMOVIDA_PELO_USUARIO_RECEBEDOR`, `REMOVIDA_PELO_PSP`.
`cpf`	string	não	Só as cobranças com esse `devedor.cpf`.
`cnpj`	string	não	Só as cobranças com esse `devedor.cnpj`. Use `cpf` ou `cnpj`, nunca os dois.
`subconta`	string	não	Só as cobranças daquela sub-conta.
`situacaoFundos`	string	não	O estado do dinheiro: `RECEBIDO`, `CREDITADO`, `RETIDO`, `EM_DEVOLUCAO` ou `DEVOLVIDO`. Aceita vários, separados por vírgula. `status=CONCLUIDA&situacaoFundos=RECEBIDO,EM_DEVOLUCAO` é o que foi pago e ainda não virou saldo.

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	`filtro_invalido`	`cpf` e `cnpj` juntos.
400	`limite_invalido`	`limite` fora de 1 a 200.
400	`periodo_invalido`	`inicio` ou `fim` fora do RFC 3339.
400	`status_invalido`	`status` ou `situacaoFundos` fora da lista.
403	`subconta_de_outro`	A credencial é de uma sub-conta e pediu outra.