--- title: "Get settlement account transactions" method: GET path: "/virtual-accounts/{accountId}/transactions" tags: ["Settlement Accounts"] --- # Get settlement account transactions `GET /virtual-accounts/{accountId}/transactions` The `GET /virtual-accounts/{accountId}/transactions` endpoint retrieves transcation information in a given settlement account. ## Path parameters - `accountId` string, required ## Query parameters - `limit` integer - `offset` string - `refId` string - `startDate` string - `endDate` string - `amount` string - `providerPaymentId` string - `transactionType` 'INVALID_TYPE' | 'DEBIT' | 'CREDIT' — Specifies the type of transaction. - `onBehalfOfId` string ## Response `200` Successful response - GetVirtualAccountTransactionsResponse - `pageInfo` PageInfo — The information about the current page, which also indicates whether the next page exists. - `limit` integer, required — The limit (maximum number of objects to return) applied to this page.
The default and maximum allowed limit is 200. If this limit is exceeded, was not set or was set to 0, it will be set to 200. - `offset` string — The offset for the current page. If the offset has been provided in the request, this offset will be equal to the provided one. But if no offset is provided in the request (i.e. this is the first page) and the page is not empty, this field will be populated with a non-empty string. This may be helpful for loading the same page again, which might not always be possible with an empty offset due to the dynamic nature of the data.
The offset is opaque to a user and should not be parsed and/or understood in any way. - `nextOffset` string — The offset for the next page. If the page is empty, it is equal to this page offset. If the page is not empty, but there are no more objects to load (haveMore = false), it will be empty.
The offset is opaque to a user and should not be parsed and/or understood in any way. - `haveMore` boolean — This field indicates whether there are more objects to load, i.e. whether the next page exists. - `transactions` VirtualAccountTransactions[] - `amount` object — The balance currency and value. - `currency` string, required — The ISO 4217 three letter currency code. - `value` string, required — The transaction amount with up to four digits after the decimal point. - `providerPaymentId` string — The settlement account provider-assigned unique transaction identifier. - `createdDateTime` string — The date and time this refund object was created (in ISO 8601 format). - `description` string — The description of the transaction. - `transactionType` 'INVALID_TYPE' | 'DEBIT' | 'CREDIT' — Specifies the type of transaction. - `localInstrument` 'SEPA' | 'SEPA_INSTANT' | 'FASTER_PAYMENTS' — The bank's payment service to be used for making a payment. - `debtor` union — Debtor information. Provide either an Account on File OR full Debtor Account details. These two modes are mutually exclusive. - 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), ISO 9362, 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, required — The debtor’s account owner name. - `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), ISO 9362, 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, required — The debtor’s account owner name. - `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, required — The debtor’s account owner name. - `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), ISO 9362, 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, required — The debtor’s account owner name. - `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), ISO 9362, 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, required — The debtor’s account owner name. - `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), ISO 9362, 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, required — The debtor’s account owner name. - `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, required — The debtor’s account owner name. - `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), ISO 9362, 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, required — The debtor’s account owner name. - `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), ISO 9362, 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, required — The debtor’s account owner name. - `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, required — The debtor’s account owner name. - `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), ISO 9362, 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, required — The debtor’s account owner name. - `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 Nordea. - `bic` string — The Business Identifier Code (BIC), ISO 9362, 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, required — The debtor’s account owner name. - `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). - TokenizedAccountIdentifier - `tokenizedAccountId` string, required — Account on File identifier. - `creditor` 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), ISO 9362, 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - 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), ISO 9362, 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - object — Polish account details where the account number is required and the bic is optional. - `accountNumber` string, required — The payee's Elixir-registered bank account number. - `bic` string — The Business Identifier Code (BIC), ISO 9362, 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - 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), ISO 9362, 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - 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), ISO 9362, 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - 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), ISO 9362, 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - object — Account details where the iban and bban are required and the bic and clearing number are optional. This is ONLY allowed for an HP flow if there is no `bankId` provided in the initiation AND the currency is SEK or NOK. - `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. - `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), ISO 9362, 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." - `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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - 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), ISO 9362, 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - 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), ISO 9362, 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - object — Account details where the iban and bban are required and the bic and clearing number are optional. This is ONLY allowed for an HP flow if there is no `bankId` provided in the initiation AND the currency is SEK or NOK. - `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. - `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), ISO 9362, 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." - `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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - 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), ISO 9362, 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - 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 Nordea. - `bic` string — The Business Identifier Code (BIC), ISO 9362, 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, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - object — The creditor settlement account details. - `virtualAccountId` string, required — The unique identifier for the settlement account. This field is mandatory for unregulated TPPs. - `name` string, required — The owner's name for the creditor account. This parameter is not required for settlement accounts. - `ultimateCreditorName` string — The ultimate creditor'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). - `bankName` string — The creditor's bank name. - `refId` string — The TPP-generated reference identifier for the token. This is not to be confused with the `requestId`. The `refId` maps to the `tppRefId` in the bank's `consentRequest`. This is needed to match/verify the originating token request with the bank's consent request.
We recommend that the `refId` should not contain special characters (the allowed characters are the 26-letter Latin alphabet, the numerical digits from 0-9 and the hyphen '-'). This field should not exceed 18 characters in length. ## 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 an account, was not found - `429` — Too many requests - `500` — An unexpected or internal server error - `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)