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
| Header | Type | Status | Description |
|---|---|---|---|
Authorization | string | Required | Bearer token obtained via POST /v1/oauth2/token. |
Content-Type | string | Required | application/json |
Body Parameters (JSON)
| Parameter | Type | Status | Description |
|---|---|---|---|
walletId | string | Required | 13-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"]
}