---
title: "List card transactions"
method: GET
path: "/v4/spend/profiles/{profileId}/cards/{cardToken}/transactions"
tags: ["card-transaction"]
---

# List card transactions

`GET /v4/spend/profiles/{profileId}/cards/{cardToken}/transactions`

Retrieve a list of card transactions for a specific card. Transactions are ordered by transaction ID in descending order.

Use in conjunction with the [card transaction state change webhook](/api-reference/webhook-event/eventcardstransactionstatechange) for versions V2.1.0 and later.

{% admonition type="warning" %}
Only transactions created in the past 90 days can be accessed. A 422 error code will be returned otherwise.
{% /admonition %}

The `debits` and `credits` fields are not included in list responses. Use the [Get card transaction](/api-reference/card-transaction/cardtransactionget) endpoint to retrieve these fields.

## Path parameters

- `profileId` integer, required
- `cardToken` string, uuid, required

## Query parameters

- `fromCreationTime` string, date-time, required
- `toCreationTime` string, date-time, required
- `pageSize` integer
- `lastId` integer

## Headers

- `X-External-Correlation-Id` string, uuid

## Response `200`

Card transactions retrieved successfully.

- object
  - `transactions` CardTransaction[]
    - `id` integer — ID of the transaction
    - `cardToken` string — Unique identifier of the card
    - `type` 'ACCOUNT_CREDIT' | 'ACCOUNT_FUNDING' | 'CASH_ADVANCE' | 'CASH_WITHDRAWAL' | 'CHARGEBACK' | 'CREDIT_TRANSACTION' | 'ECOM_PURCHASE' | 'POS_PURCHASE' | 'REFUND' — [Type](/api-reference/card-transaction#card-transaction-type) of the transaction. One of: - `ACCOUNT_CREDIT` - `ACCOUNT_FUNDING` - `CASH_ADVANCE` - `CASH_WITHDRAWAL` - `CHARGEBACK` - `CREDIT_TRANSACTION` - `ECOM_PURCHASE` - `POS_PURCHASE` - `REFUND`
    - `state` 'IN_PROGRESS' | 'COMPLETED' | 'DECLINED' | 'CANCELLED' | 'UNKNOWN' — The current [state](/api-reference/card-transaction#card-transaction-state) of the transaction. One of: - `IN_PROGRESS` - `COMPLETED` - `DECLINED` - `CANCELLED` - `UNKNOWN`
    - `declineReason` string, nullable — Code of the [decline reason](/api-reference/card-transaction#card-transaction-decline-reasons) if applicable
    - `detailedDeclineReason` string, nullable — Code of the [detailed decline reason](/api-reference/card-transaction#card-transaction-detailed-decline-reasons) if applicable
    - `creationTime` string, date-time — When the transaction was created
    - `modificationTime` string, date-time — When the transaction was last updated
    - `purgeTime` string, date-time, nullable — Time at which reserved funds will be released after the authorisation hold expires
    - `transactionAmount` object — Transaction amount, including any embedded fees such as ATM fees that are not applied by Wise
      - `amount` number — Transaction amount
      - `currency` string — Currency code
    - `fees` object[] — Array of fees
      - `amount` number — Fee amount
      - `currency` string — Currency code
      - `fee_type` string — Fee type
    - `transactionAmountWithFees` object — Transaction amount including all fees
      - `amount` number — Transaction amount including all fees
      - `currency` string — Currency code
    - `merchant` object — Merchant information
      - `name` string — Name of the merchant
      - `location` object — Merchant location
        - `country` string, nullable — Country where merchant is located
        - `city` string, nullable — City where merchant is located
        - `zipCode` string, nullable — Zip code where merchant is located
        - `region` string, nullable — Region where merchant is located
        - `state` string, nullable — State where merchant is located
      - `category` object — Merchant category
        - `name` string — Category of the merchant
        - `code` string — MCC code of the merchant
        - `description` string — Description of the merchant category
    - `authorisationMethod` string — Authorisation method
    - `approvalCode` string, nullable — Also called authorization code. This can be used to prove ownership of a customer's card/account to a merchant
    - `billingAmount` object — Billing amount
      - `amount` number — Billing amount
      - `currency` string — Currency code
    - `arn` string, nullable — Acquirer reference number
    - `pinValidationResult` 'ONLINE_PIN_VALIDATED' | 'ONLINE_PIN_INVALID' | 'OFFLINE_PIN_VALIDATED' | 'OFFLINE_PIN_INVALID' | 'NOT_RECEIVED', nullable — PIN validation result. One of: - `ONLINE_PIN_VALIDATED` - `ONLINE_PIN_INVALID` - `OFFLINE_PIN_VALIDATED` - `OFFLINE_PIN_INVALID` - `NOT_RECEIVED`
    - `balanceChannelReferenceId` string, nullable — Balance channel reference ID associated with the card transaction
    - `debits` object[] — Array of debits. Only present when retrieving a single transaction by ID. The debits list is a non-aggregated list of debit movements, meaning that the `balanceId` is not unique in the list. For example, a cancelled transaction may have a list of 2 debits where the absolute values of `debitedAmount.amount`, `forAmount.amount` and `fee.amount` are the same, but one is the negation of the other due to a reservation (first debit) which was then released (second debit with negated amounts). You can choose to perform the aggregation in your system or display the full list of debits to the end customer.
      - `balanceId` integer — Balance ID
      - `debitedAmount` object — Amount taken from the balance
        - `amount` number — Amount
        - `currency` string — Currency code
      - `forAmount` object — Amount converted to
        - `amount` number — Amount
        - `currency` string — Currency code
      - `rate` number — Exchange rate of debitedAmount to forAmount
      - `fee` object — Conversion fee
        - `amount` number — Conversion fee amount
        - `currency` string — Currency code
      - `creationTime` string, date-time — Creation time of debit
    - `credits` object[] — Array of credits. Only present when retrieving a single transaction by ID
      - `balanceId` integer — Balance ID
      - `creditedAmount` object — Amount credited to the balance
        - `amount` number — Amount
        - `currency` string — Currency code
      - `creationTime` string, date-time — Creation time of credit
    - `relayAuthorisationData` object, nullable — Relayed authorisation response data, only available if the partner has opted in for [relayed authorisation](/guides/product/issue-cards/relayed-authorisation)
      - `responseCode` 'APPROVED' | 'PROCESSING_ERROR' | 'NON_SUPPORTED_CURRENCY' | 'NON_SUPPORTED_MCC_FOR_COUNTRY' | 'BLOCKED_COUNTRY' | 'TRANSACTION_TYPE_NOT_SUPPORTED' | 'SUSPECTED_FRAUD' — [ResponseCode](/guides/product/issue-cards/relayed-authorisation#authorisation-response) of the relayed authorisation. One of: - `APPROVED` - `PROCESSING_ERROR` - `NON_SUPPORTED_CURRENCY` - `NON_SUPPORTED_MCC_FOR_COUNTRY` - `BLOCKED_COUNTRY` - `TRANSACTION_TYPE_NOT_SUPPORTED` - `SUSPECTED_FRAUD`
      - `fallback` boolean — Indicating whether there was a fallback applied by Wise

## Other responses

- `429` — Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

---

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