Listar cobros

Lista los cobros de la cuenta, del más reciente al más antiguo, con cursor.

GET /v2/ex/cobrancas

Alcance: 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	Obligatorio	Descripción
`limite`	entero	no	Elementos por página, de 1 a 200. Por defecto, 50.
`cursor`	string	no	El `cursor.proximo` de la página anterior.
`inicio`, `fim`	string	no	Intervalo de creación, RFC 3339: `inicio` se incluye, `fim` no se incluye. Para un día completo, use `fim` con la medianoche del día siguiente.
`status`	string	no	Filtra por estado: `ATIVA`, `CONCLUIDA`, `REMOVIDA_PELO_USUARIO_RECEBEDOR`, `REMOVIDA_PELO_PSP`.
`cpf`	string	no	Solo los cobros con ese `devedor.cpf`.
`cnpj`	string	no	Solo los cobros con ese `devedor.cnpj`. Use `cpf` o `cnpj`, nunca los dos.
`subconta`	string	no	Solo los cobros de esa subcuenta.
`situacaoFundos`	string	no	El estado del dinero: `RECEBIDO`, `CREDITADO`, `RETIDO`, `EM_DEVOLUCAO` o `DEVOLVIDO`. Acepta varios, separados por comas. `status=CONCLUIDA&situacaoFundos=RECEBIDO,EM_DEVOLUCAO` es lo que se pagó y todavía no se convirtió en saldo.

El listado no trae el pixCopiaECola. Para reenviar el QR, use Consultar cobro.

GET /v2/cob?inicio=...&fim=... es el listado en el formato estándar del Banco Central, por intervalo de creación.

Errores #

Estado	`title`	Cuándo
400	`cursor_invalido`	Cursor mal formado.
400	`filtro_invalido`	`cpf` y `cnpj` juntos.
400	`limite_invalido`	`limite` fuera de 1 a 200.
400	`periodo_invalido`	`inicio` o `fim` fuera de RFC 3339.
400	`status_invalido`	`status` o `situacaoFundos` fuera de la lista.
403	`subconta_de_outro`	La credencial es de una subcuenta y solicitó otra.