List charges

Lists the charges of the account, from the most recent to the oldest, with a cursor.

GET /v2/ex/cobrancas

Scope: 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 }
}

Parameter	Type	Required	Description
`limite`	integer	no	Items per page, from 1 to 200. Default 50.
`cursor`	string	no	The `cursor.proximo` of the previous page.
`inicio`, `fim`	string	no	Creation interval, RFC 3339: `inicio` is included, `fim` is not. For a whole day, use `fim` with midnight of the following day.
`status`	string	no	Filters by status: `ATIVA`, `CONCLUIDA`, `REMOVIDA_PELO_USUARIO_RECEBEDOR`, `REMOVIDA_PELO_PSP`.
`cpf`	string	no	Only the charges with that `devedor.cpf`.
`cnpj`	string	no	Only the charges with that `devedor.cnpj`. Use `cpf` or `cnpj`, never both.
`subconta`	string	no	Only the charges of that sub-account.
`situacaoFundos`	string	no	The state of the money: `RECEBIDO`, `CREDITADO`, `RETIDO`, `EM_DEVOLUCAO` or `DEVOLVIDO`. Accepts several, separated by commas. `status=CONCLUIDA&situacaoFundos=RECEBIDO,EM_DEVOLUCAO` is what was paid and has not become balance yet.

The listing does not carry the pixCopiaECola. To resend the QR, use Get charge.

GET /v2/cob?inicio=...&fim=... is the listing in the standard Central Bank of Brazil format, by creation interval.

Errors #

Status	`title`	When
400	`cursor_invalido`	Malformed cursor.
400	`filtro_invalido`	`cpf` and `cnpj` together.
400	`limite_invalido`	`limite` outside 1 to 200.
400	`periodo_invalido`	`inicio` or `fim` outside RFC 3339.
400	`status_invalido`	`status` or `situacaoFundos` outside the list.
403	`subconta_de_outro`	The credential belongs to a sub-account and asked for another one.