List payouts
Lists the payouts of the account, from the most recent to the oldest, with a cursor.
GET /v2/ex/pix
Scope: ex.pix.send.read.
GET /v2/ex/pix?limite=2
→ 200
{
"payouts": [
{
"idEnvio": "SAQ01J1ZK7M9QW3ERT5TY6UI8O",
"endToEndId": "E12345678202609181200000000000003",
"status": "EM_PROCESSAMENTO",
"tipo": "SAQUE",
"valor": "300.00",
"solicitadoEm": "2026-09-18T12:00:00Z",
"prazoRegulatorio": "2026-09-18T14:00:00Z",
"favorecido": { "chave": "12345678909", "cpf": "12345678909" },
"sla": { "estouradoNaEntrada": false, "restanteSegundos": 7199 }
}
],
"cursor": { "proximo": "", "temMais": false }
}
| 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, when we received the payout, RFC 3339. fim is not included. |
status |
string | no | AGUARDANDO_APROVACAO, EM_PROCESSAMENTO, REALIZADO or NAO_REALIZADO. |
cpf, cnpj |
string | no | Only the payouts to the beneficiary with this document, with or without the mask. One of the two. |
subconta |
string | no | Only the payouts of that sub-account. |
ordem |
string | no | prazo: the deadline queue, from the shortest deadline to the longest, only with status=EM_PROCESSAMENTO and only the payouts that have a deadline. The first page brings the most urgent ones. Omitted, from the most recent to the oldest. |
Each item has the shape of Get payout. A payee that is a legal entity comes with cnpj instead of cpf.
Errors #
| Status | title |
When |
|---|---|---|
| 400 | cursor_invalido |
Malformed cursor. |
| 400 | periodo_invalido |
inicio or fim outside RFC 3339. |
| 400 | limite_invalido |
limite outside 1 to 200. |
| 400 | status_invalido |
status outside the list. |
| 400 | filtro_invalido |
ordem outside the list, prazo without status=EM_PROCESSAMENTO, or cpf and cnpj together. |