--- title: "Get Transaction Report" method: GET path: "/data/v2/transaction-reports/{id}" tags: ["Data v2.Transaction Report"] --- # Get Transaction Report `GET /data/v2/transaction-reports/{id}` Reports are available for retrieval up to 1h after generation and permanently deleted after 24h. ## Path parameters - `id` string, required ## Response `200` A successful response. - TinkTransactionhistoryReportsV2Report - `accounts` TinkTransactionhistoryReportsV2Account[] — Accounts list in the report. - `balances` TinkTransactionhistoryReportsV2AccountBalances - `available` TinkTransactionhistoryReportsV2AccountBalance - `amount` TinkTypeCurrencyDenominatedAmount — 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. - `booked` TinkTransactionhistoryReportsV2AccountBalance - `amount` TinkTypeCurrencyDenominatedAmount — 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. - `customerSegment` 'UNDEFINED_CUSTOMER_SEGMENT' | 'PERSONAL' | 'BUSINESS' — - UNDEFINED_CUSTOMER_SEGMENT: Undefined segment. - PERSONAL: Personal segment. - BUSINESS: Business segment. - `dates` TinkTransactionhistoryReportsV2AccountDates - `lastRefreshed` string, date-time — Timestamp of last account data refresh (date and time in ISO-8601 standard). - `financialInstitutionId` string — ID of the financial institution the account belongs to. - `id` string — Internal Tink accounts identifier. - `identifiers` TinkTransactionhistoryReportsV2AccountIdentifiers - `financialInstitution` TinkTransactionhistoryReportsV2AccountIdentifiersFinancialInstitution - `accountNumber` string — Account number. - `referenceNumbers` object — Additional identifiers used by the financial institution to uniquely reference the account. - `iban` TinkTransactionhistoryReportsV2AccountIdentifiersIBAN - `bban` string — BBAN represents an country-specific bank account number. - `bic` string — BIC bank number. This can be inferred from the IBAN, but some banks might require it for adding a beneficiary or will display it for existing accounts owned by the user. - `iban` string — IBAN represents an international bank account number. - `pan` TinkTransactionhistoryReportsV2AccountIdentifiersPan - `masked` string — The masked PAN (card number). - `sortCode` TinkTransactionhistoryReportsV2AccountIdentifiersSortCode - `accountNumber` string — Account number. - `code` string — Code value. - `name` string — Account name as seen in the bank. - `type` 'UNDEFINED' | 'CHECKING' | 'SAVINGS' | 'CREDIT_CARD' — - UNDEFINED: Type undefined. - CHECKING: Checking account. - SAVINGS: Savings account. - CREDIT_CARD: Credit card account. - `createdAt` string, required — [BETA] The date and time when transaction report was created. Specified as a ISO-8601 date and time string in UTC (e.g. 2020-12-15T09:25:12Z). - `externalReference` string - `id` string, required — Tink unique identifier for the report. - `merchantId` string — [BETA] An id of the merchant. This field is only returned when it is provided by the client when creating the Tink Link Session. - `transactions` TinkTransactionhistoryTransactionsV2Transaction[] — Transactions list in the report. - `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 - `401` — Authorization token is missing, or not valid - `403` — You are not allowed to access the requested resource - `404` — The report was not found. - `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)