Transactions

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

transactions

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

// Incremental sync: walk forward from the last id you ingested
let anchor = 'txn_01HW9R5Q3AB7N8MTX1RVTXNDEF';
for (;;) {
  const url = new URL('https://api.vexioncards.one/v1/transactions');
  url.searchParams.set('ending_before', anchor);
  url.searchParams.set('limit', '100');
  const page = await (await fetch(url, {
    headers: { Authorization: `Bearer ${process.env.VXN_API_KEY}` },
  })).json();
  if (page.data.length === 0) break;
  for (const txn of page.data.reverse()) ingest(txn);   // oldest-first
  anchor = page.data[0].id;                              // newest of this page
}

import os, requests

params = {"customer_id": "cus_01HW9R4P2ZK7N8MTX1RVABCDEF", "limit": 100}
headers = {"Authorization": f"Bearer {os.environ['VXN_API_KEY']}"}
while True:
    page = requests.get("https://api.vexioncards.one/v1/transactions",
                        headers=headers, params=params).json()
    for txn in page["data"]:
        print(txn["id"], txn["type"], txn["value"], txn["unit"])
    if not page["has_more"]:
        break
    params["starting_after"] = page["data"][-1]["id"]

{
  "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): the person who booked the entry. Only matches source: "manual" entries - the only origin that carries a person. The account owner's id also matches older manual entries recorded before the person was captured. 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

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]

Unix seconds lower bound (inclusive).

created[lte]

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

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"

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

// Incremental sync: walk forward from the last id you ingested
let anchor = 'txn_01HW9R5Q3AB7N8MTX1RVTXNDEF';
for (;;) {
  const url = new URL('https://api.vexioncards.one/v1/transactions');
  url.searchParams.set('ending_before', anchor);
  url.searchParams.set('limit', '100');
  const page = await (await fetch(url, {
    headers: { Authorization: `Bearer ${process.env.VXN_API_KEY}` },
  })).json();
  if (page.data.length === 0) break;
  for (const txn of page.data.reverse()) ingest(txn);   // oldest-first
  anchor = page.data[0].id;                              // newest of this page
}

import os, requests

params = {"customer_id": "cus_01HW9R4P2ZK7N8MTX1RVABCDEF", "limit": 100}
headers = {"Authorization": f"Bearer {os.environ['VXN_API_KEY']}"}
while True:
    page = requests.get("https://api.vexioncards.one/v1/transactions",
                        headers=headers, params=params).json()
    for txn in page["data"]:
        print(txn["id"], txn["type"], txn["value"], txn["unit"])
    if not page["has_more"]:
        break
    params["starting_after"] = page["data"][-1]["id"]

{
  "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"
}

API Reference

MCP server

Customers

Cards

Transactions

Products

Notifications

Locations

Team members

Custom fields

Events

Webhook endpoints

API keys

Organization

Icons

API Reference

List transactions

Common patterns

Authorizations

Query Parameters

Response