Listar saques
Lista os saques da conta, do mais recente para o mais antigo, com cursor.
GET /v2/ex/pix
Escopo: 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 }
}
| 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, quando recebemos o saque, RFC 3339. fim não entra. |
status |
string | não | AGUARDANDO_APROVACAO, EM_PROCESSAMENTO, REALIZADO ou NAO_REALIZADO. |
cpf, cnpj |
string | não | Só os saques ao favorecido com este documento, com ou sem a máscara. Um dos dois. |
subconta |
string | não | Só os saques daquela sub-conta. |
ordem |
string | não | prazo: a fila do prazo, do mais curto para o mais longo, só com status=EM_PROCESSAMENTO e só os saques com prazo. A primeira página traz os mais urgentes. Omitido, do mais recente para o mais antigo. |
Cada item tem a forma de Consultar saque. O favorecido pessoa jurídica vem com cnpj no lugar de cpf.
Erros #
| Status | title |
Quando |
|---|---|---|
| 400 | cursor_invalido |
Cursor malformado. |
| 400 | periodo_invalido |
inicio ou fim fora do RFC 3339. |
| 400 | limite_invalido |
limite fora de 1 a 200. |
| 400 | status_invalido |
status fora da lista. |
| 400 | filtro_invalido |
ordem fora da lista, prazo sem status=EM_PROCESSAMENTO, ou cpf e cnpj juntos. |