---
title: "List Card Transactions"
method: GET
path: "/api/v1/cards/transactions"
tags: ["Transactions"]
---

# List Card Transactions

`GET /api/v1/cards/transactions`

Retrieves paginated transactions for all activated cards of the authenticated user.

Returns three types of transaction events:
- **Payment**: Regular card transactions (purchases, ATM withdrawals). Can appear immediately after authorization with `isPending: true`, then update when cleared.
- **Refund**: Money returned to your account (product returns, cancellations). Only appears after both authorization and clearing are processed.
- **Reversal**: Cancellation of previous transactions due to technical issues or merchant corrections. Can appear immediately after authorization-level reversals.

The final number might differ slightly, as one thread might contain multiple transactions.

## Query parameters

- `cardTokens` string
- `limit` integer
- `offset` integer
- `before` string, date-time
- `after` string, date-time
- `billingCurrency` string
- `transactionCurrency` string
- `mcc` string
- `transactionType` string

## Response `200`

Successful response with paginated transaction events

- object
  - `count` integer — Total number of transactions available
  - `next` string, nullable — URL for the next page of results, null if no more pages
  - `previous` string, nullable — URL for the previous page of results, null if on first page
  - `results` Event[] — Array of transaction events for the current page
    - union
      - Payment
        - `threadId` string — Thread ID for the transaction
        - `createdAt` string, date-time
        - `clearedAt` string, date-time, nullable — Date of the latest clearing record of the transaction
        - `country` Country
          - `name` string
          - `numeric` string
          - `alpha2` string
          - `alpha3` string
        - `isPending` boolean — Whether the transaction is pending settlement. - For Payments: true when authorized but not yet cleared, false when settled - For Refunds: can be true if additional clearing steps are pending, typically false since they require both auth + clearing to appear - For Reversals: typically false as they're usually processed quickly
        - `impactsCashback` boolean, nullable — Indicates whether this transaction impacted cashback eligibility: - `true`: Transaction was eligible for and impacted cashback - `false`: Transaction did not impact cashback (not eligible) - `null`: Unable to determine (e.g., before user accepted cashback terms)
        - `mcc` string
        - `merchant` object
          - `name` string
          - `city` string
          - `country` Country
            - `name` string
            - `numeric` string
            - `alpha2` string
            - `alpha3` string
        - `billingAmount` string — A BigInt value represented as a string
        - `billingCurrency` Currency
          - `symbol` string
          - `code` string
          - `decimals` integer
          - `name` string
        - `transactionAmount` string — A BigInt value represented as a string
        - `transactionCurrency` Currency
          - `symbol` string
          - `code` string
          - `decimals` integer
          - `name` string
        - `transactionType` string — First 2 digits of the DE3 field (ISO 8583), representing the transaction type code. Common values include (not limited to): - "00": Purchase (POS) - "01": Withdrawal (ATM) - "10": Account Funding - "20": Return of Goods - "28": Prepaid Load - "30": Balance Inquiry - "70": PIN Change - "72": PIN Unblock
        - `cardToken` string — The token identifying the card used for this transaction
        - `transactions` Transaction[]
          - `status` 'Unsubmitted' | 'Unconfirmed' | 'ExecReverted' | 'ExecSuccess'
          - `to` string
          - `value` string — A BigInt value represented as a string
          - `data` string
          - `hash` string, nullable
        - `kind` 'Payment'
        - `status` 'Approved' | 'IncorrectPin' | 'InsufficientFunds' | 'ExceedsApprovalAmountLimit' | 'InvalidAmount' | 'PinEntryTriesExceeded' | 'IncorrectSecurityCode' | 'Reversal' | 'PartialReversal' | 'Other'
      - Refund
        - `threadId` string — Thread ID for the transaction
        - `createdAt` string, date-time
        - `clearedAt` string, date-time, nullable — Date of the latest clearing record of the transaction
        - `country` Country
          - `name` string
          - `numeric` string
          - `alpha2` string
          - `alpha3` string
        - `isPending` boolean — Whether the transaction is pending settlement. - For Payments: true when authorized but not yet cleared, false when settled - For Refunds: can be true if additional clearing steps are pending, typically false since they require both auth + clearing to appear - For Reversals: typically false as they're usually processed quickly
        - `impactsCashback` boolean, nullable — Indicates whether this transaction impacted cashback eligibility: - `true`: Transaction was eligible for and impacted cashback - `false`: Transaction did not impact cashback (not eligible) - `null`: Unable to determine (e.g., before user accepted cashback terms)
        - `mcc` string
        - `merchant` object
          - `name` string
          - `city` string
          - `country` Country
            - `name` string
            - `numeric` string
            - `alpha2` string
            - `alpha3` string
        - `billingAmount` string — A BigInt value represented as a string
        - `billingCurrency` Currency
          - `symbol` string
          - `code` string
          - `decimals` integer
          - `name` string
        - `transactionAmount` string — A BigInt value represented as a string
        - `transactionCurrency` Currency
          - `symbol` string
          - `code` string
          - `decimals` integer
          - `name` string
        - `transactionType` string — First 2 digits of the DE3 field (ISO 8583), representing the transaction type code. Common values include (not limited to): - "00": Purchase (POS) - "01": Withdrawal (ATM) - "10": Account Funding - "20": Return of Goods - "28": Prepaid Load - "30": Balance Inquiry - "70": PIN Change - "72": PIN Unblock
        - `cardToken` string — The token identifying the card used for this transaction
        - `transactions` Transaction[]
          - `status` 'Unsubmitted' | 'Unconfirmed' | 'ExecReverted' | 'ExecSuccess'
          - `to` string
          - `value` string — A BigInt value represented as a string
          - `data` string
          - `hash` string, nullable
        - `kind` 'Refund'
        - `refundAmount` string — A BigInt value represented as a string
        - `refundCurrency` Currency
          - `symbol` string
          - `code` string
          - `decimals` integer
          - `name` string
      - Reversal
        - `threadId` string — Thread ID for the transaction
        - `createdAt` string, date-time
        - `clearedAt` string, date-time, nullable — Date of the latest clearing record of the transaction
        - `country` Country
          - `name` string
          - `numeric` string
          - `alpha2` string
          - `alpha3` string
        - `isPending` boolean — Whether the transaction is pending settlement. - For Payments: true when authorized but not yet cleared, false when settled - For Refunds: can be true if additional clearing steps are pending, typically false since they require both auth + clearing to appear - For Reversals: typically false as they're usually processed quickly
        - `impactsCashback` boolean, nullable — Indicates whether this transaction impacted cashback eligibility: - `true`: Transaction was eligible for and impacted cashback - `false`: Transaction did not impact cashback (not eligible) - `null`: Unable to determine (e.g., before user accepted cashback terms)
        - `mcc` string
        - `merchant` object
          - `name` string
          - `city` string
          - `country` Country
            - `name` string
            - `numeric` string
            - `alpha2` string
            - `alpha3` string
        - `billingAmount` string — A BigInt value represented as a string
        - `billingCurrency` Currency
          - `symbol` string
          - `code` string
          - `decimals` integer
          - `name` string
        - `transactionAmount` string — A BigInt value represented as a string
        - `transactionCurrency` Currency
          - `symbol` string
          - `code` string
          - `decimals` integer
          - `name` string
        - `transactionType` string — First 2 digits of the DE3 field (ISO 8583), representing the transaction type code. Common values include (not limited to): - "00": Purchase (POS) - "01": Withdrawal (ATM) - "10": Account Funding - "20": Return of Goods - "28": Prepaid Load - "30": Balance Inquiry - "70": PIN Change - "72": PIN Unblock
        - `cardToken` string — The token identifying the card used for this transaction
        - `transactions` Transaction[]
          - `status` 'Unsubmitted' | 'Unconfirmed' | 'ExecReverted' | 'ExecSuccess'
          - `to` string
          - `value` string — A BigInt value represented as a string
          - `data` string
          - `hash` string, nullable
        - `kind` 'Reversal'
        - `reversalAmount` string — A BigInt value represented as a string
        - `reversalCurrency` Currency
          - `symbol` string
          - `code` string
          - `decimals` integer
          - `name` string

## Other responses

- `401` — Unauthorized Error
- `500` — Internal Server Error

---

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