---
title: "List operations"
method: GET
path: "/operations"
tags: ["Operations"]
---

# List operations

`GET /operations`

Retrieves a paginated list of all company transactions (purchases, refunds, rewards).
Use `cursor` for efficient pagination through large result sets.
The `offset` parameter is deprecated — use `cursor` instead.

## Query parameters

- `max` integer
- `offset` integer
- `cursor` string

## Response `200`

Operation list

- object
  - `rows` Operation — A completed loyalty transaction (purchase, refund, or reward). Contains transaction details, customer info, cashier info, and point movements. Uses discriminator on `action` field.
    - `id` integer — Transaction ID in the UDS database.
    - `dateCreated` string, date-time — Transaction date.
    - `action` 'PURCHASE', required — Transaction type.
    - `state` 'NORMAL' | 'CANCELED' | 'REVERSAL' — Transaction lifecycle status: * `NORMAL` — active transaction, loyalty benefits applied * `CANCELED` — transaction was canceled, no loyalty impact * `REVERSAL` — transaction was refunded, loyalty benefits reversed (points returned, cashback deducted)
    - `customer` object — Customer information.
      - `id` integer — Customer ID in the company.
      - `displayName` string — Customer name.
      - `uid` string, nullable — Customer ID in UDS (UID).
      - `membershipTier` MembershipTier — Membership tier (loyalty level) configuration. Defines the discount/cashback rate and automatic upgrade conditions based on spending or referral count.
        - `uid` string — Tier ID.
        - `name` string, required — Tier name.
        - `rate` number, required — Tier rate.
        - `maxScoresDiscount` number, nullable — The maximum discount (in percentage) allowed when redeeming points.
        - `conditions` object — Conditions to upgrade customer tiers automatically.
          - `totalCashSpent` object, nullable — Upgrade to tier when customer reaches target `cashSpent`.
            - `target` number — Amount of cash spent.
          - `effectiveInvitedCount` object, nullable — Upgrade to tier when customer reaches target `effectiveInvitedCount`.
            - `target` integer — Amount of invited count.
    - `cashier` object, nullable — Cashier information.
      - `id` integer — Cashier ID.
      - `displayName` string — Cashier name.
    - `branch` object, nullable — Branch information.
      - `id` integer — Branch ID.
      - `displayName` string — Branch name.
    - `points` number — The amount of points which changed customer balance as a result of the operation. A negative value means write-off of bonus points and a positive value means point accrual.
    - `certificatePoints` number, nullable — Number of deducted certificate points.
    - `receiptNumber` string, nullable — Receipt number.
    - `origin` object, nullable — Reference to origin operation (for operations in state REVERSAL).
      - `id` integer — Origin transaction ID.
  - `total` integer
  - `cursor` string — Use this cursor for next request

---

[API](https://skmtc.dev/uds/apis/uds-api.md) · [All operations](https://skmtc.dev/uds/apis/uds-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uds/uds-api/revisions/6fbbbc79e671/schema)