# Get Brand Wallet Transaction History

**Method:** `GET`

**Path:** `/payment-option/wallet/customer/{customer_id}/history`

**Category:** Brand Wallet

**Authentication:** Required

## Description

Retrieves wallet transaction history for a customer with optional filters
by date range, page, and transaction type.


## Path Parameters

- `customer_id` (`string`) **required** — Unique customer identifier (e.g. cust-v1-...).

## Query Parameters

- `start_date` (`string`) **required** — Start date for the history range.
- `end_date` (`string`) **required** — End date for the history range.
- `page` (`integer`) — Page number for pagination (defaults to 1).
- `transaction_type` (`string[]`) — Filter by transaction type(s). Can be repeated for multiple types.

## Responses

- `200` — Transaction history retrieved.
- `400` — 
- `401` — 
- `500` — 

### Response Schema

- `data` (`object`)
  - `transactions` (`BrandWalletTransactionHistory[]`)
    - `transaction_date_time` (`string`) — When the transaction occurred
    - `outlet_name` (`string`)
    - `transaction_type` (`string`) — e.g. CREDIT, DEBIT
    - `transaction_amount` (`number`) — Transaction amount (in currency units, not paisa)
    - `currency_code` (`string`)
    - `account_balance` (`number`) — Balance after this transaction
    - `merchant_name` (`string`)
    - `reason` (`string`)
    - `transaction_id` (`integer`)
    - `response_message` (`string`)
    - `transaction_status` (`string`) — e.g. COMPLETED, FAILED



### Example Response

```json
{
  "data": {
    "transactions": []
  }
}
```

---

Reference: https://localhost:3000/api/brand-wallet/get-brand-wallet-history