Ir para o conteúdo
A AmunPay API PixVersão 3.38 · atualizada em Páginas

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.