Customer Wallet Transactions

GET

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

Retrieves a paginated list of wallet transactions for a specific customer.

🔑Scopes

third_customer_wallet_read - Customer Wallet Read

Request

Path Params

Query 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/transactions/?page=1&page_size=20' \
--header 'Store-Id: 123456' \
--header 'X-manager-Token: {{Access-Token}}'

Response Example

200 - Example 1

{
    "results": [
        {
            "transaction_id": "transaction_12345",
            "transaction_number": "TXN-100245",
            "amount": "100",
            "currency": "SAR",
            "type": "credit",
            "status": "completed",
            "description": "Promotional wallet credit",
            "order_id": 456789,
            "created_at": "2026-09-01T10:30:00Z",
            "expires_at": "2026-12-31T23:59:59Z"
        },
        {
            "transaction_id": "transaction_12345",
            "transaction_number": "TXN-100245",
            "amount": 100,
            "currency": "SAR",
            "type": "credit",
            "status": "completed",
            "description": "Promotional wallet credit",
            "order_id": 456789,
            "created_at": "2026-09-01T10:30:00Z",
            "expires_at": "2026-12-31T23:59:59Z"
        },
        {
            "transaction_id": "transaction_12345",
            "transaction_number": "TXN-100245",
            "amount": 100,
            "currency": "SAR",
            "type": "credit",
            "status": "completed",
            "description": "Promotional wallet credit",
            "order_id": 456789,
            "created_at": "2026-09-01T10:30:00Z",
            "expires_at": "2026-12-31T23:59:59Z"
        }
    ],
    "total": 57,
    "page": 1,
    "page_size": 20
}

Modified at 2026-09-02 10:03:00

Customer Pending Cashbacks

Customers