List payouts

Quick Reference

WhatList the payouts of a wallet

WhyReconcile and monitor outbound payments, with filters and pagination

Reading Time3 min

DifficultyBeginner

PrerequisitesAuthentication → A wallet_uuid

GET/api/v1/bank/wallet/payout/Bearer TokenList payouts for a wallet

Returns a paginated list of the payouts funded by a wallet. Supports MagicQuery filter and sort expressions.

---

Query parameters

Param	Type	Required	Default	Description
wallet_uuid	string (UUID)	Yes	—	Wallet to list payouts for
page	integer	No	1	Page number
limit	integer	No	10	Items per page
filter	string	No	—	MagicQuery filter expression (e.g. status:eq:realized)
sort	string	No	—	MagicQuery sort expression (e.g. created:desc)

Request headers

Header	Value	Required
Authorization	Bearer {A55_ACCESS_TOKEN}	Yes

---

Response fields

Field	Type	Description
page	integer	Current page
limit	integer	Items per page
total	integer	Total number of payouts
pages	integer	Total number of pages
data	array	List of payout objects (same shape as Get payout)

---

Error responses

Status	Code	Description
401	unauthorized	Invalid or expired Bearer token
404	errors.wallet.not_found	Wallet not found

---

Code examples

cURL

curl -s "https://sandbox.api.a55.tech/api/v1/bank/wallet/payout/?wallet_uuid=f47ac10b-58cc-4372-a567-0e02b2c3d479&filter=status:eq:realized&sort=created:desc&page=1&limit=20" \
  -H "Authorization: Bearer $A55_ACCESS_TOKEN"

Python

import requests
import os

token = os.environ["A55_ACCESS_TOKEN"]
base = os.environ.get("A55_API_URL", "https://sandbox.api.a55.tech")

result = requests.get(
    f"{base}/api/v1/bank/wallet/payout/",
    params={
        "wallet_uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "filter": "status:eq:realized",
        "sort": "created:desc",
        "page": 1,
        "limit": 20,
    },
    headers={"Authorization": f"Bearer {token}"},
).json()

print(f"{result['total']} payouts across {result['pages']} pages")

Node.js

const token = process.env.A55_ACCESS_TOKEN;
const base = process.env.A55_API_URL || "https://sandbox.api.a55.tech";

const params = new URLSearchParams({
  wallet_uuid: "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  filter: "status:eq:realized",
  sort: "created:desc",
  page: "1",
  limit: "20",
});

const result = await fetch(`${base}/api/v1/bank/wallet/payout/?${params}`, {
  headers: { Authorization: `Bearer ${token}` },
}).then((r) => r.json());

console.log(`${result.total} payouts across ${result.pages} pages`);

---

Response example

{
  "page": 1,
  "limit": 20,
  "total": 2,
  "pages": 1,
  "data": [
    {
      "payout_uuid": "9b1f0c88-3a3c-4f2f-9d6e-1f0a2d4e88c1",
      "status": "realized",
      "type_payout": "pix",
      "amount": 100.00,
      "currency": "BRL",
      "beneficiary_name": "João Silva",
      "transaction_reference": "PAY-2048",
      "created": "2026-06-16T18:00:00Z"
    },
    {
      "payout_uuid": "5c2a13f0-5e74-4b21-9c6a-2bd9d9b0aa10",
      "status": "issued",
      "type_payout": "cash_pickup",
      "amount": 200.00,
      "currency": "USD",
      "beneficiary_name": "Pedro",
      "transaction_reference": "PAY-2052",
      "created": "2026-06-16T18:05:00Z"
    }
  ]
}

---

Create payout →Send a new outbound payment from a wallet.Get payout →Retrieve a single payout by id.Payout webhook →Receive a notification when the payout status changes.