Account Lookup

Verify a wallet ID exists and get the masked account holder name. Always call this before paying a user to prevent sending money to the wrong person.

POST/v1/wallet/lookupLive & Sandbox

Request Headers

HeaderTypeStatusDescription
AuthorizationstringRequiredBearer token obtained via POST /v1/oauth2/token.
Content-TypestringRequiredapplication/json

Body Parameters (JSON)

ParameterTypeStatusDescription
walletIdstringRequired13-digit customer account number starting with 38 or sovereign wallet ID (e.g. 3810482910482).

Request Code Snippets (cURL, Node, Python, PHP, Go)

Request Example
curl -X POST https://developer.vixzz.com/v1/wallet/lookup \
  -H "Authorization: Bearer vxz_tok_c2b_8f9k3m9s2a1l" \
  -H "Content-Type: application/json" \
  -d '{
    "walletId": "3810482910482"
  }'

JSON Return Response Body (200 OK)

Response
{
  "exists": true,
  "walletId": "wal_live_381048291048",
  "accountNumber": "3810482910482",
  "maskedName": "I***** F**** A********",
  "accountHolderName": "I***** F**** A********",
  "currency": "KES",
  "status": "ACTIVE",
  "permittedRails": ["C2B_PAYMENTS", "B2C_PAYOUT", "P2P_ESCROW"]
}