---
title: "Get Customer Transactions"
method: GET
path: "/customer/transactions"
---

# Get Customer Transactions

`GET /customer/transactions`

Retrieves transaction history of a customer which includes the following information. Transaction type, gross transaction amount, transaction date, points issued, points redeemed, coupons redeemed and so on.

By default, it shows up to 10 results and shows results based on the `limit` passed.

* There is no upper limit for number of transactions.
* There is no duration based limit.

## Query parameters

- `identifierName` 'mobile' | 'email' | 'external_id id', required
- `identifierValue` string, required
- `entity_type` 'ZONE' | 'CONCEPT' | 'STORE' | 'TILL' | 'STR_SERVER'
- `entity_code` string
- `number` string
- `transaction_id` integer
- `store_id` string
- `store_code` string
- `start_id` integer
- `end_id` integer
- `start_date` string, date
- `end_date` string, date
- `credit_notes` boolean
- `custom_fields` boolean
- `points_breakup` boolean
- `limit` integer
- `offset` integer
- `sort` 'trans_date' | 'trans_id'
- `order` 'asc' | 'desc'
- `mlp` boolean

## Response `200`

200

- object
  - `response` object
    - `status` object
      - `success` string
      - `code` integer
      - `message` string
    - `customer` object
      - `firstname` string
      - `lastname` string
      - `user_id` string
      - `mobile` string
      - `email` string
      - `external_id` string
      - `lifetime_points` integer
      - `lifetime_purchases` integer
      - `loyalty_points` integer
      - `current_slab` string
      - `registered_on` string
      - `updated_on` string
      - `type` string
      - `source` string
      - `count` integer
      - `start` string
      - `delayed_points` string
      - `delayed_returned_points` string
      - `total_available_points` string
      - `total_returned_points` string
      - `rows` string
      - `transactions` object
        - `transaction` object[]
          - `id` string
          - `number` string
          - `type` string
          - `return_type` string
          - `amount` string
          - `outlier_status` string
          - `delivery_status` string
          - `notes` string
          - `billing_time` string
          - `auto_update_time` string
          - `gross_amount` string
          - `discount` string
          - `store` string
          - `store_code` string
          - `returned_points_on_bill` string
          - `currency` object
            - `ratio` integer
            - `transaction_currency` object
              - …
            - `id` integer
            - `name` string
            - `symbol` string
          - `points` object
            - `issued` string
            - `redeemed` string
            - `returned` string
            - `expired` string
            - `returnedPointsOnBill` string
            - `expiry_date` string
            - `program_id` string
          - `custom_fields` object
            - `field` object[]
              - …
          - `extended_fields` object
            - `field` unknown[]
              - …
          - `coupons` unknown[]
            - unknown
          - `basket_size` integer
          - `line_items` object
            - `line_item` unknown[]
              - …
      - `item_status` object
        - `success` string
        - `code` string
        - `message` string
        - `warnings` object
          - `warning` unknown[]
            - unknown

## Other responses

- `400` — 400

---

[API](https://skmtc.net/capillarytech/apis/sample-api.md) · [All operations](https://skmtc.net/capillarytech/apis/sample-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/capillarytech/sample-api/versions/de241f2ed9b3/schema)