---
title: "GET /v2/customers/{merchant_id}/transactions"
method: GET
path: "/v2/customers/{merchant_id}/transactions"
tags: ["customers"]
---

# GET /v2/customers/{merchant_id}/transactions

`GET /v2/customers/{merchant_id}/transactions`

## Path parameters

- `merchant_id` string, required

## Query parameters

- `type` 'csv' | 'json'
- `since_id` integer
- `limit` integer
- `cursor` string — Fetch another page of results using a cursor returned in a previous response
- `created_at_min` string
- `created_at_max` string

## Response `200`

200

- union
  - object
    - `transactions` union[], required
      - union
        - object
          - `id` number, required
          - `customer` object, required — The customer linked to the transaction. The attached fields describe the _current_ state of the customer as the API response is generated, not their state at the time of the transaction
            - `id` number, required
            - `merchant_id` string, required
            - `email` string, nullable, required
            - `points_pending` number, required
            - `points_approved` number, required
            - `points_spent` number, required
          - `points_approved` number, required — Number of approved points added or removed
          - `points_pending` number, required — Number of pending points added or removed
          - `created_at` string, required — `ISO 8601` timestamp representing the time of the transaction
          - `resource` 'activity', required
          - `activity` union, required
            - TransactionActivity
              - …
            - TransactionActivityWithOrder
              - …
        - object
          - `id` number, required
          - `customer` object, required — The customer linked to the transaction. The attached fields describe the _current_ state of the customer as the API response is generated, not their state at the time of the transaction
            - `id` number, required
            - `merchant_id` string, required
            - `email` string, nullable, required
            - `points_pending` number, required
            - `points_approved` number, required
            - `points_spent` number, required
          - `points_approved` number, required — Number of approved points added or removed
          - `points_pending` number, required — Number of pending points added or removed
          - `created_at` string, required — `ISO 8601` timestamp representing the time of the transaction
          - `resource` 'adjustment', required
          - `adjustment` object, required
            - `note` string, nullable, required — The customer-visible note for this adjustment
        - object
          - `id` number, required
          - `customer` object, required — The customer linked to the transaction. The attached fields describe the _current_ state of the customer as the API response is generated, not their state at the time of the transaction
            - `id` number, required
            - `merchant_id` string, required
            - `email` string, nullable, required
            - `points_pending` number, required
            - `points_approved` number, required
            - `points_spent` number, required
          - `points_approved` number, required — Number of approved points added or removed
          - `points_pending` number, required — Number of pending points added or removed
          - `created_at` string, required — `ISO 8601` timestamp representing the time of the transaction
          - `resource` 'expiry', required
          - `expiry` object, required
            - `note` string, nullable, required — The customer-visible note for this adjustment
        - object
          - `id` number, required
          - `customer` object, required — The customer linked to the transaction. The attached fields describe the _current_ state of the customer as the API response is generated, not their state at the time of the transaction
            - `id` number, required
            - `merchant_id` string, required
            - `email` string, nullable, required
            - `points_pending` number, required
            - `points_approved` number, required
            - `points_spent` number, required
          - `points_approved` number, required — Number of approved points added or removed
          - `points_pending` number, required — Number of pending points added or removed
          - `created_at` string, required — `ISO 8601` timestamp representing the time of the transaction
          - `resource` 'claimed_reward', required
          - `claimed_reward` object, required — The claimed reward linked to this transaction
            - `id` number, required
            - `claimed_at` string, required — `ISO 8601` timestamp indicating when this reward was claimed
            - `point_cost` number, required — The number of points it cost to claim this reward
            - `redeemable` union, required
              - …
            - `reward` union, required
              - …
            - `state` 'approved' | 'declined' | 'expired' | 'pending' | 'void', required
            - `session` object, nullable, required — For session-based rewards, this includes information about the session in which the reward was claimed
              - …
            - `auto_refund_at` string, nullable, required — `ISO 8601` timestamp indicating when this reward will automatically be voided and refunded if it has not yet been used, or `null` if not applicable
            - `expires_at` string, nullable, required — Deprecated in favour of `auto_refund_at`
    - `cursor` object, required
      - `prev` string, nullable, required
      - `next` string, nullable, required
  - string

## Other responses

- `400` — Bad Request
- `401` — 401
- `403` — 403
- `404` — 404

---

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