Skip to content
A AmunPay API PixVersion 3.38 · updated on Pages

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.