---
title: "List Cards Transactions"
method: GET
path: "/v1/issuing/transactions"
tags: ["Transactions"]
---

# List Cards Transactions

`GET /v1/issuing/transactions`

Returns a list of issuing transaction objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.

## Query parameters

- `page_size` integer, required
- `page_number` integer, required
- `card_id` string, uuid
- `start_time` string
- `end_time` string

## Headers

- `x-on-behalf-of` string

## Response `200`

OK - Card transactions returned successfully.

- object
  - `total_pages` integer — The total pages of available items.
  - `total_items` integer — The total counts of available items.
  - `data` CardTranactionsResponse[]
    - `card_id` string, required — Unique identifier for the card.
    - `card_number` string, required — Masked card number
    - `cardholder_id` string, uuid, required — The cardholder's unique identifier.
    - `transaction_id` string, uuid, required — Unique Identifier for transaction
    - `short_transaction_id` string, uuid, required — Short unique identifier for transaction.
    - `original_transaction_id` string, uuid, required — Unique Identifier for the original transaction.
    - `transaction_type` 'AUTHORIZATION' | 'REFUND' | 'FUND COLLECTION' | 'ATM DEPOSIT' | 'REVERSAL' | 'VALIDATION' | 'SETTLEMENT DEBIT' | 'SETTLEMENT CREDIT' | 'SETTLEMENT REVERSAL' | 'CHARGEBACK DEBIT' | 'CHARGEBACK CREDIT', required — Transaction type of card. - `AUTHORIZATION`: Funds reserved due to card usage. - `REFUND`: Refunding the purchase amount back to account balance. - `FUND COLLECTION`: Inbound funds posted to the cardholder's card account, reported by the card network. Triggered by the network (not by a cardholder API call); distinct from CARD RECHARGE. - `ATM DEPOSIT`: Funds deposited to the account via an ATM. - `REVERSAL`: Reversing an authorization. - `VALIDATION`: Card Binding Verification. - `SETTLEMENT DEBIT`: Netting and deduction of reconciliation discrepancies. - `SETTLEMENT CREDIT`: Netting and crediting of reconciliation discrepancies. - `SETTLEMENT REVERSAL`: Netting and reversal of reconciliation discrepancies. - `CHARGEBACK DEBIT`: Funds debited due to chargebacks. - `CHARGEBACK CREDIT`: Funds credited due to chargebacks.
    - `transaction_fee` number, required — Transaction fee.
    - `transaction_fee_currency` string, required — Transaction fee currency.
    - `fee_pass_through` 'Y' | 'N', required — Indicates whether this transaction carries a pass-through low-transaction fee (LOW_TRANSACTION_FEE). * `Y` – The transaction triggered the low-transaction-fee rule; `transaction_fee` / `transaction_fee_currency` carry that pass-through fee. * `N` – No such pass-through fee applies (default). Only triggered when the transaction amount (in USD) falls within the card's configured low-transaction-fee threshold range.
    - `card_available_balance` number, required — The card available balance.
    - `authorization_code` string, required — Authorization Code
    - `billing_amount` number, required — Billing amount
    - `billing_currency` string, required — Billing Currency
    - `transaction_amount` number, required — Transaction amount
    - `transaction_currency` string, required — Transaction currency
    - `transaction_time` string, required — Transaction occurrence time
    - `posted_time` string — Transaction posted time
    - `merchant_data` MerchantData — Details about the merchant (grocery store, e-commerce website, etc.) involved in this transaction.
      - `category_code` string — The merchant category code for the merchant's business.
      - `city` string — City where the merchant is located
      - `country` string — Country where the merchant is located
      - `name` string — Name of the merchant
    - `description` string, required — Provides additional context based on the transaction status. - If `transaction_status` is `DECLINED`, this field contains the reason for the failure. - If `transaction_status` is `APPROVED`, this field contains supplementary remarks(e.g. "1000 - Authorization Approval", "3DS Fee").
    - `transaction_status` 'APPROVED' | 'DECLINED' | 'PENDING', required — The high-level status indicating the stage of the transaction lifecycle.
    - `wallet_type` 'ApplePay' | 'GooglePay' | 'GOOGLE ECOMMERCE' | 'GOOGLE' | 'GOOGLE PAY' — Indicates which digital wallet was used for the transaction.

---

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