---
title: "Retrieve an Account on File"
method: GET
path: "/tokenized-accounts/{tokenizedAccountId}"
tags: ["Account on File"]
---

# Retrieve an Account on File

`GET /tokenized-accounts/{tokenizedAccountId}`

Retrieves an Account on File using its tokenizedAccountId.

## Path parameters

- `tokenizedAccountId` string, required

## Response `200`

Successful response

- GetTokenizedAccountResponse — Contains the response of the get tokenized account request.
  - `accountDetails` union
    - object — SEPA account details where the iban is required and the bic is optional.
      - `iban` string, required — The International Bank Account Number, used when sending interbank transfers or wiring money from one bank to another, especially across international borders. It consists of a two-letter country code followed by two check digits and up to thirty-five alphanumeric characters.
      - `bic` string — The Business Identifier Code (BIC), <a href="https://www.iso.org/standard/84108.html" target="_blank">ISO 9362</a>, is the address assigned to a bank in order to send automated payments quickly and accurately to the banks concerned. It uniquely identifies the name and country, (and sometimes the branch) of the bank involved. BICs can be either 8 or 11 characters long.
      - `name` string — The owner's name of the debtor account.
      - `ultimateDebtorName` string — The ultimate debtor's name.
      - `address` Address — Address
        - `addressLine` string[]
        - `streetName` string — Street number
        - `buildingNumber` string — Building number
        - `postCode` string — Post Code
        - `townName` string — Town name
        - `state` string — State
        - `district` string — The district.
        - `country` string — Two-letter country code in upper case (ISO 3166-1 alpha-2).
    - object — SEPA Instant account details where the iban is required and the bic is optional.
      - `iban` string, required — The International Bank Account Number, used when sending interbank transfers or wiring money from one bank to another, especially across international borders. It consists of a two-letter country code followed by two check digits and up to thirty-five alphanumeric characters.
      - `bic` string — The Business Identifier Code (BIC), <a href="https://www.iso.org/standard/84108.html" target="_blank">ISO 9362</a>, is the address assigned to a bank in order to send automated payments quickly and accurately to the banks concerned. It uniquely identifies the name and country, (and sometimes the branch) of the bank involved. BICs can be either 8 or 11 characters long.
      - `name` string — The owner's name of the debtor account.
      - `ultimateDebtorName` string — The ultimate debtor's name.
      - `address` Address — Address
        - `addressLine` string[]
        - `streetName` string — Street number
        - `buildingNumber` string — Building number
        - `postCode` string — Post Code
        - `townName` string — Town name
        - `state` string — State
        - `district` string — The district.
        - `country` string — Two-letter country code in upper case (ISO 3166-1 alpha-2).
    - object — A UK or Irish account where the sort code and account number are required.
      - `accountNumber` string, required — The unique identifier for the bank account in the UK or Ireland.
      - `sortCode` string, required — The number assigned to a branch of a bank, typically containing six digits and most commonly used in the UK and Ireland.
      - `name` string — The owner's name of the debtor account.
      - `ultimateDebtorName` string — The ultimate debtor's name.
      - `address` Address — Address
        - `addressLine` string[]
        - `streetName` string — Street number
        - `buildingNumber` string — Building number
        - `postCode` string — Post Code
        - `townName` string — Town name
        - `state` string — State
        - `district` string — The district.
        - `country` string — Two-letter country code in upper case (ISO 3166-1 alpha-2).
    - object — Polish account details where the iban is required and the bic is optional.
      - `iban` string, required — The International Bank Account Number, used when sending interbank transfers or wiring money from one bank to another, especially across international borders. It consists of a two-letter country code followed by two check digits and up to thirty-five alphanumeric characters.
      - `bic` string — The Business Identifier Code (BIC), <a href="https://www.iso.org/standard/84108.html" target="_blank">ISO 9362</a>, is the SWIFT Address assigned to a bank in order to send automated payments quickly and accurately to the banks concerned. It uniquely identifies the name and country, (and sometimes the branch) of the bank involved. BICs are often called SWIFT Codes and can be either 8 or 11 characters long."
      - `name` string — The owner's name of the debtor account.
      - `ultimateDebtorName` string — The ultimate debtor's name.
      - `address` Address — Address
        - `addressLine` string[]
        - `streetName` string — Street number
        - `buildingNumber` string — Building number
        - `postCode` string — Post Code
        - `townName` string — Town name
        - `state` string — State
        - `district` string — The district.
        - `country` string — Two-letter country code in upper case (ISO 3166-1 alpha-2).
    - object — Account details where the iban is required and the bic is optional.
      - `iban` string, required — The International Bank Account Number, used when sending interbank transfers or wiring money from one bank to another, especially across international borders. It consists of a two-letter country code followed by two check digits and up to thirty-five alphanumeric characters.
      - `bic` string — The Business Identifier Code (BIC), <a href="https://www.iso.org/standard/84108.html" target="_blank">ISO 9362</a>, is the SWIFT Address assigned to a bank in order to send automated payments quickly and accurately to the banks concerned. It uniquely identifies the name and country, (and sometimes the branch) of the bank involved. BICs are often called SWIFT Codes and can be either 8 or 11 characters long."
      - `name` string — The owner's name of the debtor account.
      - `ultimateDebtorName` string — The ultimate debtor's name.
      - `address` Address — Address
        - `addressLine` string[]
        - `streetName` string — Street number
        - `buildingNumber` string — Building number
        - `postCode` string — Post Code
        - `townName` string — Town name
        - `state` string — State
        - `district` string — The district.
        - `country` string — Two-letter country code in upper case (ISO 3166-1 alpha-2).
    - object — Account details where the bban is required and the bic is optional.
      - `bban` string, required — Represents a country-specific bank account number. The BBAN is the last part of the IBAN when used for international funds transfers. Every country has its own specific BBAN format and length. At present, there is no common EU or other standard unifying the BBAN. This is why IBAN was introduced to standardise international bank transfers.
      - `bic` string — The Business Identifier Code (BIC), <a href="https://www.iso.org/standard/84108.html" target="_blank">ISO 9362</a>, is the SWIFT Address assigned to a bank in order to send automated payments quickly and accurately to the banks concerned. It uniquely identifies the name and country, (and sometimes the branch) of the bank involved. BICs are often called SWIFT Codes and can be either 8 or 11 characters long."
      - `name` string — The owner's name of the debtor account.
      - `ultimateDebtorName` string — The ultimate debtor's name.
      - `address` Address — Address
        - `addressLine` string[]
        - `streetName` string — Street number
        - `buildingNumber` string — Building number
        - `postCode` string — Post Code
        - `townName` string — Town name
        - `state` string — State
        - `district` string — The district.
        - `country` string — Two-letter country code in upper case (ISO 3166-1 alpha-2).
    - object — Account details where the bban is required and the clearing number is optional.
      - `bban` string, required — Represents a country-specific bank account number. The BBAN is the last part of the IBAN when used for international funds transfers. Every country has its own specific BBAN format and length. At present, there is no common EU or other standard unifying the BBAN. This is why IBAN was introduced to standardise international bank transfers.
      - `clearingNumber` string — The bank clearing number or BC number is a number used for the identification of financial institutions in Switzerland and Liechtenstein. Bank clearing numbers are connected to the Swiss Interbank Clearing and the EuroSIC system.
      - `name` string — The owner's name of the debtor account.
      - `ultimateDebtorName` string — The ultimate debtor's name.
      - `address` Address — Address
        - `addressLine` string[]
        - `streetName` string — Street number
        - `buildingNumber` string — Building number
        - `postCode` string — Post Code
        - `townName` string — Town name
        - `state` string — State
        - `district` string — The district.
        - `country` string — Two-letter country code in upper case (ISO 3166-1 alpha-2).
    - object — Account details where the iban is required and the bic is optional.
      - `iban` string, required — The International Bank Account Number, used when sending interbank transfers or wiring money from one bank to another, especially across international borders. It consists of a two-letter country code followed by two check digits and up to thirty-five alphanumeric characters.
      - `bic` string — The Business Identifier Code (BIC), <a href="https://www.iso.org/standard/84108.html" target="_blank">ISO 9362</a>, is the SWIFT Address assigned to a bank in order to send automated payments quickly and accurately to the banks concerned. It uniquely identifies the name and country, (and sometimes the branch) of the bank involved. BICs are often called SWIFT Codes and can be either 8 or 11 characters long."
      - `name` string — The owner's name of the debtor account.
      - `ultimateDebtorName` string — The ultimate debtor's name.
      - `address` Address — Address
        - `addressLine` string[]
        - `streetName` string — Street number
        - `buildingNumber` string — Building number
        - `postCode` string — Post Code
        - `townName` string — Town name
        - `state` string — State
        - `district` string — The district.
        - `country` string — Two-letter country code in upper case (ISO 3166-1 alpha-2).
    - object — Account details where the bban is required and the bic is optional.
      - `bban` string, required — Represents a country-specific bank account number. The BBAN is the last part of the IBAN when used for international funds transfers. Every country has its own specific BBAN format and length. At present, there is no common EU or other standard unifying the BBAN. This is why IBAN was introduced to standardise international bank transfers.
      - `bic` string — The Business Identifier Code (BIC), <a href="https://www.iso.org/standard/84108.html" target="_blank">ISO 9362</a>, is the SWIFT Address assigned to a bank in order to send automated payments quickly and accurately to the banks concerned. It uniquely identifies the name and country, (and sometimes the branch) of the bank involved. BICs are often called SWIFT Codes and can be either 8 or 11 characters long."
      - `name` string — The owner's name of the debtor account.
      - `ultimateDebtorName` string — The ultimate debtor's name.
      - `address` Address — Address
        - `addressLine` string[]
        - `streetName` string — Street number
        - `buildingNumber` string — Building number
        - `postCode` string — Post Code
        - `townName` string — Town name
        - `state` string — State
        - `district` string — The district.
        - `country` string — Two-letter country code in upper case (ISO 3166-1 alpha-2).
    - object — Account details where the bban is required and the clearing number is optional.
      - `bban` string, required — Represents a country-specific bank account number. The BBAN is the last part of the IBAN when used for international funds transfers. Every country has its own specific BBAN format and length. At present, there is no common EU or other standard unifying the BBAN. This is why IBAN was introduced to standardise international bank transfers.
      - `clearingNumber` string — The bank clearing number or BC number is a number used for the identification of financial institutions in Switzerland and Liechtenstein. Bank clearing numbers are connected to the Swiss Interbank Clearing and the EuroSIC system.
      - `name` string — The owner's name of the debtor account.
      - `ultimateDebtorName` string — The ultimate debtor's name.
      - `address` Address — Address
        - `addressLine` string[]
        - `streetName` string — Street number
        - `buildingNumber` string — Building number
        - `postCode` string — Post Code
        - `townName` string — Town name
        - `state` string — State
        - `district` string — The district.
        - `country` string — Two-letter country code in upper case (ISO 3166-1 alpha-2).
    - object — Account details where the bankgiroNumber is required and the bic is optional.
      - `bankgiroNumber` string, required — The unique identifier for the bank account in Sweden (known in Swedish as Bankgironummer), it consists of 7 or 8 digits.
      - `bic` string — The Business Identifier Code (BIC), <a href="https://www.iso.org/standard/84108.html" target="_blank">ISO 9362</a>, is the address assigned to a bank in order to send automated payments quickly and accurately to the banks concerned. It uniquely identifies the name and country, (and sometimes the branch) of the bank involved. BICs can be either 8 or 11 characters long.
      - `name` string — The owner's name of the debtor account.
      - `ultimateDebtorName` string — The ultimate debtor's name.
      - `address` Address — Address
        - `addressLine` string[]
        - `streetName` string — Street number
        - `buildingNumber` string — Building number
        - `postCode` string — Post Code
        - `townName` string — Town name
        - `state` string — State
        - `district` string — The district.
        - `country` string — Two-letter country code in upper case (ISO 3166-1 alpha-2).
    - object — Account details where the plusgiroNumber is required and the bic is optional.
      - `plusgiroNumber` string, required — The unique identifier for the Swedish money transaction system owned by <a href="https://www.nordea.com" target="blank">Nordea</a>.
      - `bic` string — The Business Identifier Code (BIC), <a href="https://www.iso.org/standard/84108.html" target="_blank">ISO 9362</a>, is the SWIFT Address assigned to a bank in order to send automated payments quickly and accurately to the banks concerned. It uniquely identifies the name and country, (and sometimes the branch) of the bank involved. BICs are often called SWIFT Codes and can be either 8 or 11 characters long."
      - `name` string — The owner's name of the debtor account.
      - `ultimateDebtorName` string — The ultimate debtor's name.
      - `address` Address — Address
        - `addressLine` string[]
        - `streetName` string — Street number
        - `buildingNumber` string — Building number
        - `postCode` string — Post Code
        - `townName` string — Town name
        - `state` string — State
        - `district` string — The district.
        - `country` string — Two-letter country code in upper case (ISO 3166-1 alpha-2).

## Other responses

- `400` — The client specified an invalid argument
- `401` — The authorization information is missing or invalid
- `403` — Permission to access this endpoint is denied
- `404` — The requested entity, such as tokenized account, was not found
- `429` — Too many requests
- `500` — An unexpected internal server error occurred while processing the request.
- `501` — The operation was not implemented
- `503` — Service is unavailable
- `504` — Gateway has timed out

---

[API](https://skmtc.net/token/apis/token-io-s-open-banking-api-for-tpps.md) · [All operations](https://skmtc.net/token/apis/token-io-s-open-banking-api-for-tpps/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/token/token-io-s-open-banking-api-for-tpps/versions/5e8d6d2c24a1/schema)