Skip to main content
GET
/
partner
/
wallets
/
recipients
List saved recipients
curl --request GET \
  --url https://api.stabyl.com/v1/partner/wallets/recipients \
  --header 'X-Api-Key: <api-key>'
{
  "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"
}

Documentation Index

Fetch the complete documentation index at: https://stabyl.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

Recipient list

​
data
object[]
required
​
status
enum<string>
required
Available options:
success