List transactions

Lists ledger entries newest first (created_at desc, id desc tiebreak). Cursor pagination: default 25, max 100; filters compose with the cursor.

Common patterns

• Customer history: ?customer_id=cus_...
• Cashback only: ?card_type=reward&type[]=cashback.earn&type[]=cashback.redeem
• Incremental sync from a known anchor: hold your last-ingested id and walk forward with ending_before until an empty page
• Un-reversed redemptions: ?action=redeem&reversed=false
• Reconcile one receipt: ?external_id=pos-receipt-abc-123

See Pagination.

GET /v1/transactions

cURL

cURL

curl -G https://api.vexioncards.one/v1/transactions \
  -H "Authorization: Bearer $VXN_API_KEY" \
  -d customer_id=cus_01HW9R4P2ZK7N8MTX1RVABCDEF \
  -d "type[]=points.earn" -d "type[]=points.redeem" \
  -d limit=50

200

Mixed ledger page

{
  "object": "list",
  "data": [
    {
      "id": "txn_01HW9R5Q3AB7N8MTX1RVTXNDEF",
      "object": "transaction",
      "kind": "normal",
      "type": "points.earn",
      "unit": "points",
      "card_id": "crd_01HW9R4P2ZK7N8MTX1RVCARD01",
      "card_type": "reward",
      "customer_id": "cus_01HW9R4P2ZK7N8MTX1RVABCDEF",
      "location_id": "loc_01HW9R4P2ZK7N8MTX1RVLOCS01",
      "team_member_id": null,
      "action": "award",
      "value": 18,
      "amount_minor": 1250,
      "eligible_spend_minor": null,
      "saving_minor": null,
      "currency": "EUR",
      "balance_after": {
        "points": 124
      },
      "tier_at_earning": "silver",
      "applied_multiplier": 1.5,
      "source": "api",
      "external_id": "demo-receipt-abc-123",
      "reversed": false,
      "reverses": null,
      "reversed_by": null,
      "reversed_at": null,
      "products": [
        {
          "name": "Flat White",
          "sku": "FW-12",
          "quantity": 1,
          "amount_minor": 350,
          "currency": "EUR",
          "category": "drinks"
        },
        {
          "name": "Cinnamon Roll",
          "sku": "CR-04",
          "quantity": 1,
          "amount_minor": 900,
          "currency": "EUR",
          "category": "pastry"
        }
      ],
      "metadata": {
        "till_id": "till-3"
      },
      "created_at": 1750691210,
      "occurred_at": 1750691210
    },
    {
      "id": "txn_01HXR9JNEW00000000000000A2",
      "object": "transaction",
      "kind": "normal",
      "type": "stamp.add",
      "unit": "stamps",
      "card_id": "crd_01HW9R4P2ZK7N8MTX1RVCARD02",
      "card_type": "stamp",
      "customer_id": "cus_01HW9R4P2ZK7N8MTX1RVABCDEF",
      "location_id": "loc_01HW9R4P2ZK7N8MTX1RVLOCS01",
      "team_member_id": null,
      "action": "award",
      "value": 1,
      "amount_minor": 350,
      "eligible_spend_minor": null,
      "saving_minor": null,
      "currency": "EUR",
      "balance_after": {
        "stamps_collected": 7
      },
      "tier_at_earning": null,
      "applied_multiplier": null,
      "source": "pos",
      "external_id": null,
      "reversed": false,
      "reverses": null,
      "reversed_by": null,
      "reversed_at": null,
      "products": [],
      "metadata": {},
      "created_at": 1750691100,
      "occurred_at": 1750691100
    },
    {
      "id": "txn_01HXR9JNEW00000000000000A3",
      "object": "transaction",
      "kind": "normal",
      "type": "gift_card.spend",
      "unit": "gift_card_minor",
      "card_id": "crd_01HW9R4P2ZK7N8MTX1RVCARD03",
      "card_type": "gift_card",
      "customer_id": "cus_01HW9R4P2ZK7N8MTX1RVABCDEF",
      "location_id": "loc_01HW9R4P2ZK7N8MTX1RVLOCS01",
      "team_member_id": null,
      "action": "redeem",
      "value": 450,
      "amount_minor": 450,
      "eligible_spend_minor": null,
      "saving_minor": null,
      "currency": "EUR",
      "balance_after": {
        "remaining_amount_minor": 4550
      },
      "tier_at_earning": null,
      "applied_multiplier": null,
      "source": "manual",
      "external_id": null,
      "reversed": false,
      "reverses": null,
      "reversed_by": null,
      "reversed_at": null,
      "products": [],
      "metadata": {},
      "created_at": 1750690980,
      "occurred_at": 1750690980
    }
  ],
  "has_more": true,
  "url": "/v1/transactions"
}

Authorizations

Authorization · string · header · required

Your secret API key as a Bearer token: Authorization: Bearer vxn_sk_.... Keys are created and scoped in the dashboard - see Authentication.

Query Parameters

customer_id · string

Filter to one customer.

card_id · string

Filter to one card.

card_type · enum<string>

Filter by card family. For cashback, combine card_type=reward with type[]=cashback.earn&type[]=cashback.redeem.

Available options: stamp, reward, discount, coupon, membership, gift_card, custom

location_id · string

Filter to one location.

team_member_id · string

Filter to entries recorded by one team member (tm_ id). Only matches source: "manual" scanner entries - the only origin that carries a person. Combine with created[gte|lte] for per-staff shift reports.

Pattern: ^tm_[A-Za-z0-9]+$

action · enum<string>

Filter by verb.

Available options: award, redeem

kind · enum<string>

normal or reversal. Passing tombstone returns 422 parameter_invalid - tombstones never surface.

Available options: normal, reversal

type · enum<string> enum<string>[]

Filter by transaction type. Accepts a single value (?type=points.earn) OR an array of up to 10 values (?type[]=points.earn&type[]=points.redeem) - same toggle pattern as localized fields on the Card resource.

Available options: card.issue, card.link, card.unlink, cashback.earn, cashback.redeem, coupon.issue, coupon.redeem, discount.apply, discount.tier_change, employee_discount.apply, gift_card.create, gift_card.refund, gift_card.spend, gift_card.topup, import, manual_adjust, membership.activate, membership.expire, membership.renew, membership.use, points.earn, points.manual_adjust, points.redeem, purchase, reversal, stamp.add, stamp.bonus, stamp.redeem, tier.change

source · string

Filter by origin. Known values: api, pos, manual, online, system - treat as an open set (new origins may be added). Unknown values return an empty list, not an error.

external_id · string

Exact match on your correlation reference.

created[gte] · integer string<date-time>

Unix seconds lower bound (inclusive).

created[lte] · integer string<date-time>

Unix seconds upper bound (inclusive).

reversed · boolean

true = only reversed originals; false = only un-reversed; omit for both.

limit · integer · default: 25

Page size 1-100, default 25.

Required range: 1 <= x <= 100

starting_after · string

Cursor - strictly OLDER than this txn_ id (forward/next page). Numeric offset or page parameters are not supported; cursors are the only supported paging mechanism.

ending_before · string

Cursor - strictly NEWER than this txn_ id (walk forward in time from an anchor).

Response

200

application/json

Paginated transaction list.

Cursor-paginated transaction list (newest first, created_at desc, id desc).

object · string · required

Always "list".

Allowed value: "list"

data · object[] · required

Transaction rows.

Show child attributes

has_more · boolean · required

True when more pages exist - pass the last id as starting_after.

next_cursor · string | null

Cursor for the next page in the direction you are already paging, or null when this page ends the collection. has_more: true always comes with a non-null next_cursor.

Feed it back to the SAME parameter you used: starting_after when paging forward (the default), or ending_before when paging backward. Treat it as opaque and do not parse it.

You no longer need to take the last object's id yourself. That still works and is unchanged, but deriving the cursor from the page put the burden of knowing the sort direction on you, and it broke silently on any endpoint whose cursor is not the object id.

Example:

"cus_iofv5j4hn6bphinmmyat27tc5y"

url · string

Stable collection URL.

Example:

"/v1/transactions"