How to retrieve all wallets in your organization.

List Wallets

List All Wallets

Endpoint: GET /baas/wallets

Required scope: wallet:read

bash

curl https://gateway.dev.passkallet.com/sepolia/api/v1/passkallet/baas/wallets \
  -H "x-api-key: pk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4"

json

{
  "statusCode": 200,
  "content": [
    {
      "id": "clxyz123-abc456-def789",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
      "label": "Alice Wallet",
      "externalUserId": "user_alice_001",
      "externalUserLabel": "Alice Smith",
      "createdAtDatetime": "2026-05-31T12:00:00.000Z"
    }
  ]
}

Filter Wallets

Parameter	Type	Description
`externalUserId`	string	Filter wallets by your internal user ID
`label`	string	Filter wallets by label

bash

curl "https://gateway.dev.passkallet.com/sepolia/api/v1/passkallet/baas/wallets?externalUserId=user_alice_001" \
  -H "x-api-key: pk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4"

Get Wallet User Info

Endpoint: GET /baas/wallets/:address/user

Required scope: wallet:read

Returns the external user information linked to a specific wallet address.

bash

curl https://gateway.dev.passkallet.com/sepolia/api/v1/passkallet/baas/wallets/0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18/user \
  -H "x-api-key: pk_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4"

json

{
  "statusCode": 200,
  "content": {
    "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18",
    "externalUserId": "user_alice_001",
    "externalUserLabel": "Alice Smith",
    "label": "Alice Wallet",
    "createdAtDatetime": "2026-05-31T12:00:00.000Z"
  }
}