List saved recipients

Returns saved recipient records with optional type and currency filters. Use this endpoint to keep internal tools aligned with the current account address book.

GET /partner/wallets/recipients

List saved recipients

cURL

curl --request GET \
  --url https://api.stabyl.com/v1/partner/wallets/recipients \
  --header 'X-Api-Key: <api-key>'

200

{
  "data": [
    {
      "account_name": "Example Recipient",
      "account_number": "0123456789",
      "bank_code": "044",
      "bank_name": "Access Bank",
      "chain": null,
      "created_at": "2026-05-24T12:00:00Z",
      "crypto_address": null,
      "currency": "NGN",
      "id": "0197f1f0-0000-7000-8000-000000000002",
      "label": "Operations account",
      "recipient_type": "fiat",
      "updated_at": "2026-05-24T12:00:00Z"
    }
  ],
  "status": "success"
}

Saved recipients are address book records. Creating, updating, or deleting a recipient does not submit a withdrawal or move funds.

Authorizations

X-Api-Key · string · header · default: sb_test_your_key · required

API key. Send it in the X-Api-Key header.

Query Parameters

recipient_type · null | enum<string>

Filter saved recipients by type: fiat or crypto. Saved recipient type. Fiat recipients use bank details; crypto recipients use chain and address details.

Available options: fiat, crypto

currency · string | null

Filter saved recipients by wallet currency or settlement rail.

Response

200

application/json

Recipient list

data · object[] · required

Show child attributes

status · enum<string> · required

Available options: success