---
title: "Get a list of transactions"
method: GET
path: "/issuing/transactions"
tags: ["Transactions"]
---

# Get a list of transactions

`GET /issuing/transactions`

## Request

- Base URL: `https://{prefix}.api.sandbox.checkout.com`
- URL: `https://{prefix}.api.sandbox.checkout.com/issuing/transactions`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `string` scopes: `issuing:transactions-read`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/issuing/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

<span style="font-size: 12px; font-weight: 500; color: rgb(0, 0, 0); background-color: rgb(255, 176, 97); border-radius: 4px; padding: 2px 6px" >Beta</span><p></p>
Returns a list of transactions based on the matching input parameters in reverse chronological order, with the most recent transactions shown first.

## Query parameters

- `limit` integer
- `skip` integer
- `cardholder_id` string: The cardholder's unique identifier.
- `card_id` string: The card's unique identifier.
- `entity_id` string: The entity's unique identifier.
- `status` 'authorized' | 'declined' | 'canceled' | 'cleared' | 'refunded' | 'disputed'
- `from` string, date-time
- `to` string, date-time

## Response `200`

Transactions returned successfully.

- GetTransactionsResponse
  - `limit` integer: The requested maximum number of transactions returned.
  - `skip` integer: The requested number of transactions to skip.
  - `total_count` integer: The total count of available transactions.
  - `data` IssuingTransaction[]: A list of transactions.
    - `id` string: The transaction's unique identifier.
    - `created_on` string, date-time: The date/time the transaction was created.
    - `status` 'authorized' | 'declined' | 'canceled' | 'cleared' | 'refunded' | 'disputed': The high-level status indicating the stage of the transaction lifecycle.
    - `transaction_type` 'account_funding' | 'account_transfer' | 'atm_installment' | 'balance_inquiry' | 'bill_payment' | 'cash_advance' | 'cashback' | 'credit_adjustment' | 'debit_adjustment' | 'original_credit' | 'payment_account_inquiry' | 'payment' | 'pin_change' | 'pin_unblock' | 'purchase_account_inquiry' | 'purchase' | 'quasi_cash' | 'remittance_funding' | 'remittance_payment' | 'unknown' | 'withdrawal' | 'refund': The high-level nature of the transaction.
    - `client` IssuingTransactionClient
      - `id` string: The client's unique identifier.
    - `entity` IssuingTransactionEntity
      - `id` string: The entity's unique identifier.
    - `card` IssuingTransactionCard
      - `id` string: The card's unique identifier.
      - `network` 'mastercard': The card network.
    - `digital_card` IssuingTransactionDigitalCard
      - `id` string: The digital card's unique identifier.
      - `wallet_type` 'googlepay' | 'applepay' | 'remote_commerce_programs': The wallet type.
    - `cardholder` IssuingTransactionCardholder
      - `id` string: The cardholder's unique identifier.
    - `amounts` IssuingTransactionAmounts
      - `total_held` IssuingTransactionAmount
        - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
        - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
      - `total_authorized` IssuingTransactionAmount
        - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
        - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
      - `total_reversed` IssuingTransactionAmount
        - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
        - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
      - `total_cleared` IssuingTransactionAmount
        - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
        - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
      - `total_refunded` IssuingTransactionAmount
        - `amount` number: The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
        - `currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
    - `merchant` IssuingTransactionMerchant
      - `id` string: The merchant's identifier. The identifier varies from one acquirer to another.
      - `name` string: The merchant's name.
      - `city` string: The city where the merchant is located.
      - `state` string: The state in which the merchant is located (only for US-based merchants).
      - `country_code` string: The country code where the merchant is located.
      - `category_code` string: The merchant's category codes. All category codes are documented <a href="https://www.checkout.com/docs/developer-resources/testing/codes/merchant-category-codes" target="blank">here</a>.
    - `reference_transaction` IssuingReferenceTransaction
      - `transaction_id` string: The transaction's unique identifier.
      - `reference_type` 'original_mit' | 'original_recurring'
    - `messages` IssuingTransactionMessage[]: A summarized list of messages associated to this transaction. A message can be initiated by the cardholder, merchant, acquirer, or issuer.
      - `id` string: The message's unique Checkout.com identifier.
      - `initiator` 'cardholder' | 'merchant' | 'acquirer' | 'card_network' | 'issuer': Specifies who initiated the message
      - `type` 'authorization' | 'reversal' | 'authorization_advice' | 'reversal_advice' | 'presentment' | 'authorization_refund' | 'presentment_refund' | 'presentment_reversed' | 'presentment_reversed_refund': The message type.
      - `result` 'approved' | 'declined' | 'processed': The outcome after processing this message.
      - `is_relayed` boolean: Indicates if this message was relayed through the Auth Relay to the client.
      - `indicator` 'incremental_preauthorization' | 'deferred_authorization' | 'preauthorization' | 'normal_authorization' | 'final_authorization' | 'partial_reversal' | 'full_reversal' | 'partial_presentment' | 'final_presentment' | 'unknown': Indicates the type of the authorization, reversal, or presentment.<br/> For authorization, it can be incremental_preauthorization, deferred_authorization, preauthorization, normal_authorization, final_authorization, or unknown.<br/> For reversals, it can be partial_reversal or full_reversal.<br/> For presentments, it can be partial_presentment or final_presentment.<br/> For other message type, it may be null.
      - `decline_reason` string: The reason explaining why the message was declined. Refer to our documentation for a list of possible <a href="https://www.checkout.com/docs/developer-resources/testing/codes/issuing-decline-reasons" target="blank">decline reasons</a>.<br/> If the message was approved, this will return `Null`.
      - `authorization_code` string: Your issuer authorization code for when the transaction was approved.
      - `billing_amount` integer: The transaction billing amount.<br/> The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.
      - `billing_currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
      - `transaction_amount` integer: The amount of the message in the currency the card was used in, before any currency conversion.<br/> The amount is provided in the <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency unit</a>.<br/> This is only returned when the card scheme provided the transaction amount and currency for this message.<br/> This field is only available for messages created on or after October 1, 2026. Messages created before that date have no value.
      - `transaction_currency` string, ISO4217: The issuing currency, as a three-letter <a href="https://docs.checkout.com/docs/currency-codes" target="blank">ISO currency code</a>.
      - `created_on` string, date-time: The message's creation date/time (UTC).
    - `_links` object: The links related to the transaction.
      - `self` IssuingLink
        - `href` string, required: The link URL.
        - `actions` string[], required: The HTTP Methods that can be performed on the link.
        - `types` string[], required: The Content Types for the link to the resource
      - `card` IssuingLink
        - `href` string, required: The link URL.
        - `actions` string[], required: The HTTP Methods that can be performed on the link.
        - `types` string[], required: The Content Types for the link to the resource
      - `cardholder` IssuingLink
        - `href` string, required: The link URL.
        - `actions` string[], required: The HTTP Methods that can be performed on the link.
        - `types` string[], required: The Content Types for the link to the resource
      - `reference_transaction` IssuingLink
        - `href` string, required: The link URL.
        - `actions` string[], required: The HTTP Methods that can be performed on the link.
        - `types` string[], required: The Content Types for the link to the resource

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `422`: Matching parameters not valid.
- `429`: Too Many Requests

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)