---
title: "Get Account"
method: GET
path: "/data/v2/accounts/{id}"
tags: ["Data v2.Account", "REGION.US"]
---

# Get Account

`GET /data/v2/accounts/{id}`

Returns an account for given user and id.

## Path parameters

- `id` string, required

## Response `200`

A successful response.

- TinkTransactionhistoryAccountsV2Account
  - `balances` TinkTransactionhistoryAccountsV2AccountBalances
    - `available` TinkTransactionhistoryAccountsV2AccountBalance
      - `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` TinkTransactionhistoryAccountsV2AccountBalance
      - `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'
  - `dates` TinkTransactionhistoryAccountsV2AccountDates, required
    - `lastRefreshed` string, date-time, required — Timestamp of last account data refresh (date and time in ISO-8601 standard).
  - `externalAccountId` string — External identifier of the account provided by the ingesting party. Only populated for Connector customer accounts and not for aggregated accounts.
  - `financialInstitutionId` string — ID of the financial institution the account belongs to. Since this field is applicable for aggregated accounts only, a Customer using Connector to ingest accounts can distinguish the different types of accounts by checking if this field is set or not.
  - `id` string, required — Tink unique identifier for the account report. Generated at the moment of report creation.
  - `identifiers` TinkTransactionhistoryAccountsV2AccountIdentifiers
    - `financialInstitution` TinkTransactionhistoryAccountsV2AccountIdentifiersFinancialInstitution
      - `accountNumber` string, required — The number that the user would typically recognize as their account number, for example when selecting their account in a list. For card-based accounts where the card number is also the unique account identifier, this field contains the masked PAN. For US accounts, this field would typically contain the last 4 digits of the full account number.
      - `referenceNumbers` object — Additional identifiers used by the financial institution to uniquely reference the account.
    - `iban` TinkTransactionhistoryAccountsV2AccountIdentifiersIBAN
      - `bban` string, required — 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, required — IBAN represents an international bank account number.
    - `pan` TinkTransactionhistoryAccountsV2AccountIdentifiersPan
      - `masked` string, required — The masked PAN (card number).
    - `sortCode` TinkTransactionhistoryAccountsV2AccountIdentifiersSortCode
      - `accountNumber` string, required — The BACS account number.
      - `code` string, required — The sort code of the account.
  - `name` string, required — Name of the account assigned by the account holder or by the financial institution. This field is typically what the user recognises in their online banking app.
  - `type` 'UNDEFINED' | 'CHECKING' | 'SAVINGS' | 'CREDIT_CARD', required — - UNDEFINED: Not used. - CHECKING: Checking account. - SAVINGS: Savings account. - CREDIT_CARD: Credit card account.

## Other responses

- `401` — Authorization token is missing, or not valid
- `403` — You are not allowed to access the requested resource
- `404` — Account doesn't exist
- `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)