---
title: "List Transactions"
method: GET
path: "/data/v2/transactions"
tags: ["Data v2.Transaction", "REGION.US"]
---

# List Transactions

`GET /data/v2/transactions`

Returns a list of transactions for a user.

## Query parameters

- `pageSize` string, int64
- `pageToken` string
- `accountIdIn` string[]
- `bookedDateGte` string
- `bookedDateLte` string
- `statusIn` string[]

## Response `200`

A successful response.

- TinkTransactionhistoryTransactionsV2ListTransactionsResponse
  - `nextPageToken` string — Token to retrieve the next page of results, or empty if there are no more results in the list.
  - `transactions` TinkTransactionhistoryTransactionsV2Transaction[] — There will be a maximum number of items returned based on the page_size field int the request.
    - `accountId` string, required — Tink unique identifier for the account the transaction belongs to.
    - `amount` TinkTypeCurrencyDenominatedAmount, required — The amount with regard to currency and its value should be accurately represent the monetary amount.
      - `currencyCode` string — The currency code which follows ISO-4217 standard.
      - `value` TinkTypeExactNumber — ExactNumber to use representation, which is used in `BigDecimal`. A value of `12.13` with `unscaledValue = 1213` and `scale = 2`. We can later use `doubleValue = Math.pow(10, -scale) * unscaledValue` to get exact number.
        - `scale` string, int64 — The scale of the numeric value. `unscaledValue` is used with `scale` to accurately represent floating point values. The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
        - `unscaledValue` string, int64 — The unscaled numeric value. `unscaledValue` is used with `scale` to accurately represent floating point values. The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
    - `bookedDateTime` string — [BETA] For BOOKED transactions indicates the date and time when the transaction was posted on the financial institution’s books. For PENDING transactions indicates the expected booking date and time. Specified as a ISO-8601 date and time string in UTC (e.g. 2020-12-15T09:25:12Z) or with time zone offset (e.g. 2020-12-15T10:25:12+01:00). This field is only returned when a valid timestamp is provided by the financial institution.
    - `categories` TinkTransactionhistoryTransactionsV2TransactionCategories
      - `pfm` TinkTransactionhistoryTransactionsV2TransactionCategoriesPFMCategory
        - `id` string, required — Tink category ID.
        - `name` string, required — (DEPRECATED) Tink category name. Currently not populated.
    - `counterparties` TinkTransactionhistoryTransactionsV2TransactionCounterparties
      - `payee` TinkTransactionhistoryTransactionsV2TransactionCounterpartiesCounterpartyInformation
        - `identifiers` TinkTransactionhistoryTransactionsV2TransactionCounterpartiesCounterpartyInformationIdentifiers
          - `financialInstitution` TinkTransactionhistoryTransactionsV2TransactionCounterpartiesCounterpartyInformationFinancialInstitution
            - `accountNumber` string — [BETA] Transaction counterparty account number from financial institution.
        - `name` string — [BETA] Name of a transaction counterparty from financial institution.
      - `payer` TinkTransactionhistoryTransactionsV2TransactionCounterpartiesCounterpartyInformation
        - `identifiers` TinkTransactionhistoryTransactionsV2TransactionCounterpartiesCounterpartyInformationIdentifiers
          - `financialInstitution` TinkTransactionhistoryTransactionsV2TransactionCounterpartiesCounterpartyInformationFinancialInstitution
            - `accountNumber` string — [BETA] Transaction counterparty account number from financial institution.
        - `name` string — [BETA] Name of a transaction counterparty from financial institution.
    - `dates` TinkTransactionhistoryTransactionsV2TransactionDates
      - `booked` string — For BOOKED transactions indicates the date when the transaction was posted on the financial institution’s books. For PENDING transactions indicates the expected booking date. Specified as a ISO-8601 date string (YYYY-MM-DD). Corresponds to the date displayed to the financial institution end user on their bank statement or transaction list in their online bank in the bank’s local time.
      - `transaction` string — [BETA] The date when the transaction event was first initiated. For example a date when a payment card was authorised at the point of sale (before it was booked) or when a money transfer was first initiated (before it was executed). Specified as a ISO-8601 date string (YYYY-MM-DD) in bank local timezone.
      - `value` string — The date when assets either become available or cease to be available to the account owner. Specified as a ISO-8601 date string (YYYY-MM-DD). Corresponds to the date displayed to the financial institution end user on their bank statement or transaction list in their online bank in the bank’s local time.
    - `descriptions` TinkTransactionhistoryTransactionsV2TransactionDescriptions
      - `detailed` TinkTransactionhistoryTransactionsV2TransactionTransactionInformation
        - `unstructured` string — [BETA] A detailed description from the financial institution. Intended to be shown to the end user when displaying a detailed view of a transaction. It contains a narrative, unstructured and unmodified text message with details of a transaction.
      - `display` string, required — Formatted and cleaned description intended to be shown to the end user when displaying a transactions list.
      - `original` string, required — Original unmodified description from the financial institution.
    - `id` string, required — Tink unique identifier for the transaction.
    - `identifiers` TinkTransactionhistoryTransactionsV2TransactionIdentifiers
      - `providerTransactionId` string — Transaction identifier obtained from the financial institution.
    - `merchantInformation` TinkTransactionhistoryTransactionsV2TransactionMerchantInformation
      - `merchantCategoryCode` string
      - `merchantName` string
    - `providerMutability` 'MUTABILITY_UNDEFINED' | 'MUTABLE' | 'IMMUTABLE'
    - `reference` string — Transaction reference as provided by the financial institution.
    - `status` 'UNDEFINED' | 'PENDING' | 'BOOKED', required — - UNDEFINED: (DEPRECATED) The transaction booking status is undefined. - PENDING: The transaction is pending at the financial institution. - BOOKED: The transaction is booked at the financial institution.
    - `transactionDateTime` string — [BETA] The time and date when the transaction event was first initiated. For example when a payment card was authorized at the point of sale (before it was booked) or when a money transfer was first initiated (before it was executed). Specified as a ISO-8601 date and time string in UTC (e.g. 2020-12-15T09:25:12Z) or with time zone offset (e.g. 2020-12-15T10:25:12+01:00). This field is only returned when a valid timestamp is provided by the financial institution.
    - `types` TinkTransactionhistoryTransactionsV2TransactionTypes, required
      - `financialInstitutionTypeCode` string — The financial institution's proprietary transaction type code.
      - `type` 'UNDEFINED' | 'CREDIT_CARD' | 'PAYMENT' | 'WITHDRAWAL' | 'DEFAULT' | 'TRANSFER', required — - UNDEFINED: Type undefined. - CREDIT_CARD: Credit card. - PAYMENT: Payment. - WITHDRAWAL: Withdrawal. - DEFAULT: Default. - TRANSFER: Transfer.
    - `valueDateTime` string — [BETA] The date and time when assets either become available or cease to be available to the account owner. Specified as a ISO-8601 date and time string in UTC (e.g. 2020-12-15T09:25:12Z) or with time zone offset (e.g. 2020-12-15T10:25:12+01:00). This field is only returned when a valid timestamp is provided by the financial institution.

## Other responses

- `400` — The request does not pass validation. Check the error message or the documentation of each field for more information.
- `401` — Authorization token is missing, or not valid
- `403` — You are not allowed to access the requested resource
- `default` — An unexpected error response.

---

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