SAR, AED, QAR, KWD, BHD, or OMR.Customer wallets is only available for GCC countries.after instead of page to read every wallet. Each cursor call costs the same no matter how deep you are in the list, while high page numbers stop working on large stores.GET /v1/customer-wallets/customers/?after=&page_size=100&balance_min=0?after=<next_cursor>&page_size=100&balance_min=0, keeping the same filters on every call of one walk.next_cursor is null.afterafter needs at least one wallet filter: balance_min, balance_max, expiring_in_days or expiring_before. Use balance_min=0 to read every wallet.page together with after. The request is refused.next_cursor as an opaque string. Do not build or edit it.page_size accepts 1 to 100.results, page_size and next_cursor only. total and page are not returned.after work exactly as before.curl --location 'https://api.zid.sa/v1/customer-wallets/customers/?page=1&page_size=20&after=&balance_min=100&balance_max=1000&expiring_in_days=30&expiring_before=2026-09-30' \
--header 'Store-Id: 123456' \
--header 'X-manager-Token: {{Access-Token}}'{
"results": [
{
"customer_id": 987654,
"name": "Ahmed Ali",
"phone_number": "+966501234567",
"email": "ahmed@example.com",
"balance": "250.5",
"total_balance": "300.5",
"held_balance": 50,
"currency": "SAR",
"pending_cashback": "25",
"soonest_expiry": {
"date": "2026-09-15",
"amount": 50
},
"cutoff_expiry": {
"date": "2026-09-30",
"amount": 125
}
}
],
"total": 245,
"page": 1,
"page_size": 20
}