Get Customer Wallet Balance

GET

https://api.zid.sa/v1/customer-wallets/customers/{id}/balance/

Retrieves the current wallet balance details for a specific customer.

🔑Scopes

third_customer_wallet_read - Customer Wallet Read

Request

Path Params

Header Params

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized

🔴500Internal Server error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.zid.sa/v1/customer-wallets/customers/123e4567-e89b-12d3-a456-426614174000/balance/' \
--header 'Store-Id: 123456' \
--header 'X-manager-Token: {{Access-Token}}'

Response Example

200 - Example 1

{
    "total_balance": 300.5,
    "balance": 250.5,
    "held_balance": 50,
    "currency": "SAR",
    "pending_cashback": 25
}

Modified at 2026-09-02 10:02:13

Export Customer Wallets

Credit Customer Wallet