token-io Accounts API
These endpoints provide authorized access to an authenticated user's account information.
token-io Accounts API is one of 29 APIs that Token.io publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 3 JSON Schema definitions.
Tagged areas include Account. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, a JSON-LD context, and 3 JSON Schemas.
This API exposes 8 operations across 8 paths, and defines 118 schemas. It is described by OpenAPI 3.2.0, at version 1.0.
Requests are made against a single base URL, https://api.token.io.
8 operations
8 paths
118 schemas
8 GET
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 2
token-io Accounts API declares
2 security schemes
for authenticating requests.
It accepts HTTP bearer tokens (JWT) (Bearer).
An API key is passed in the header as Authorization (BasicAuth).
Bearer— For Production and Sandbox environments. When using curl samples the authorization header is given as -H 'Authorization: Bearer + JWT' Please substitute your B…BasicAuth— For Sandbox environment only. When using curl samples the authorization header is given as -H 'Authorization: YOURAPIKEYHERE' Please substitute your Basic key…
Paths & Operations 8
Across 8 paths, the API surfaces 8 operations — 8 GET. Each is listed below with its method, path, parameters, and response codes.
Accounts 8
These endpoints provide authorized access to an authenticated user's account information.
GET
/accounts
Get information for all accounts
GET
/accounts/{accountId}
Get account information
GET
/account-balance
Get account balances
GET
/accounts/{accountId}/balance
Get an account balance
GET
/accounts/{accountId}/standing-orders
Get information for all standing orders
GET
/accounts/{accountId}/standing-orders/{standingOrderId}
Get standing order information
GET
/accounts/{accountId}/transactions
Get account transactions
GET
/accounts/{accountId}/transaction/{transactionId}
Get transaction information
Schemas 118
The contract defines 118 schemas that model the data the API accepts and returns. The most detailed are PolishApiTransactionDetails (21 properties), NextGenPsd2TransactionDetails (17 properties), AddressInfo (16 properties), Transaction (13 properties). Each schema is shown below with its type and property counts.
Cma9AccountDetailsAccountSubtype
string
This specifies the sub type of the account.
Cma9AccountDetailsAddressType
string
Specifies the type of address.
GetBalanceResponse
object
2 properties
RequestStatus
string
Specifies the status of the request.
BankTransactionCode
object
The Bank transaction code, created using the sub-elements of the structured code defined by ISO 20022 ; it concatenates the three ISO 20022 Codes - Domain Code…
2 properties
Cma9CardInstrument
object
Card instrument details required under the CMA9 API standard .
4 properties
Cma9DebtorAccount
object
The source account information for the payment, the payer's bank account.
5 properties
StetAccountIdentification
object
Bank-defined account identifiers.
2 properties
CzechApiTransactionDetails
object
Provider transaction details required under the Czech Standard for Open Banking .
4 properties
PolishApiAccountPsuRelation
object
The bank-provided information concerning the relationship between the user and an account.
3 properties
StetTransactionDetails
object
The provider account details required under the French PSD2 API standard .
7 properties
inline_response_429
object
1 property
1 required
Cma9ApiTransactionDetails
object
Provider transaction details required under the CMA9 API standard .
5 properties
AccountIdentifierPlusgiro
object
The domestic transaction clearing system in Sweden. The credit transfer function, which is part of Nordea , and used for mediating payments between accounts he…
1 property
TransferCreditorEndpoint
object
Contains information about the payee account.
4 properties
1 required
GatewayTimeoutError
object
The deadline expired before the operation could complete.
2 properties
1 required
inline_response_403
object
1 property
1 required
inline_response_503
object
1 property
1 required
PolishApiAccountDetailsAuxDataEntry
object
The bank-defined auxiliary data associated with the account.
GetAccountsResponse
object
Each object represents a unique bank account.
1 property
PolishApiNameAddress
object
Doing Business As (DBA) and/or other names and addresses of the company.
1 property
BudapestApiTransactionDetails
object
Provider transaction details required under the Budapest Bank API standards.
5 properties
Cma9CreditorAgent
object
The unique and unambiguous identification of a financial institution, as assigned under an internationally recognised or proprietary identification scheme.
4 properties
StetCreditorAccountReference
object
Information about the payee/creditor's account.
1 property
PermissionDeniedError
object
The error returned when the member is not authorized to perform the given operation: PermissionDenied. This error message will be accompanied by the reason fro…
1 property
TransactionStatus
string
Filters by transaction status. PROCESSING – This status indicates that the transaction is in process and that the final status has not been received from the b…
Account
object
Contains information about the requested bank account.
6 properties
2 required
AccountIdentifierBban
object
2 properties
Cma9AccountDetailsAddress
object
The complete postal address of a party.
2 properties
AccountIdentifierMsisdn
object
The Mobile Station International Subscriber Director Number (MSISDN) is the user's mobile phone number, used as a unique identifier to enable routing of voice…
1 property
AccountDetailsMetadataEntry
object
Additional fields returned by the bank in response to your particular request. The presence and type of metadata are dependent on the bank and generally compri…
inline_response_504
object
1 property
1 required
AccountDetails
object
Contains the details needed to identify, correlate and validate the bank account.
9 properties
4 required
BankTransactionCodeProprietary
object
A bank transaction code used within a community or within a bank; e.g. , for MT94x based transaction reports.
2 properties
NotImplementedError
object
The operation was not implemented, supported or enabled by the bank.
2 properties
1 required
CustomerData
object
Specifies the legal identity information for the account. This information is not required for settlement accounts.
2 properties
GetStandingOrdersResponse
object
3 properties
ProviderStandingOrderDetails
object
1 property
inline_response_400
object
1 property
AccountIdentifier
object
Account numbers and other strings that identify this as a unique bank account.
8 required
StetGenericIdentification
object
Bank-defined account information.
3 properties
slovakApiCreditorAccountReference
object
Information about the payee/creditor's account.
2 properties
AccountFeatures
object
Open Banking features supported for this account.
3 properties
ServiceUnavailableError
object
Service is unavailable, likely due to a transient condition; this is usually corrected with a retry.
2 properties
1 required
BalanceTypedBalance
object
3 properties
Cma9StandingOrderDetails
object
Specifies applicable non-standard (varied frequency and payment amount) recurring payment instructions and schedule.
10 properties
NextGenPsd2AccountReference
object
The unique provider account identifier required under the NextGenPSD2 standard .
6 properties
CashAccount
object
3 properties
NextGenPsd2TransactionDetails
object
Provider transaction details required under the NextGenPSD2 standard .
17 properties
Cma9DebtorAgent
object
The unique and unambiguous identification of a financial institution, as assigned under an internationally recognised or proprietary identification scheme.
4 properties
ProviderTransactionDetails
object
Specific information regarding the bank required by the respective Open Banking API standard adopted.
7 properties
MetadataEntry
object
The bank-defined data associated with the account.
AccountIdentifierIban
object
The International Bank Account Number, used when sending interbank transfers or wiring money from one bank to another, especially across international borders.
1 property
slovakApiDebtorAccountReference
object
Information about the payer/debtor's account.
2 properties
inline_response_401
object
1 property
PolishApiTypeOfProxy
string
The type of user's power of attorney for the payment account; required when the relationship type is an account representative.
PolishApiTransactionInfoZus
object
Data information for transfers to ZUS .
6 properties
PaymentNotFoundError
object
The error object returned when given payment cannot be found: ResourceNotFound.
2 properties
1 required
BankAccount
object
Specifies information about the bank account.
BudapestApiAccountReference
object
The unique provider account identifier required under the Budapest Bank API standards.
1 property
AccountIdentifierToken
object
The primary account number; the card identifier found on payment cards, such as credit cards and debit cards, as well as stored-value cards, gift cards and oth…
2 properties
BankTransactionCodeDomain
object
Bank transaction code using the sub-elements of the structured code defined by ISO 20022 . It concatenates the three ISO 20022 Codes: Domain Code, Family Code,…
3 properties
AccountIdentifierBankgiro
object
The identifier for domestic bank accounts in Sweden.
1 property
DeliveryAddress
object
Specifies the recipient's delivery address details.
10 properties
PolishApiAccountDetails
object
The provider account details required under the Polish API standard .
7 properties
PolishApiBank
object
Specifies information about the bank itself.
5 properties
AccountDetailsAccountType
string
Specifies the type of account.
Cma9CreditorAccount
object
Specifies the payee's account with the creditor.
4 properties
GetStandingOrderResponse
object
2 properties
PolishApiCurrencyRate
object
The currency conversion rate information.
3 properties
ServerError
object
This could refer to either an error by the payment service provider or the bank. When the bank reports a 5xx error, "token-external-error": "true" is set as a…
2 properties
StandingOrder
object
Contains the list of requested standing order records retrieved.
8 properties
Custom
object
Custom authorization.
2 properties
inline_response_500
object
1 property
PolishApiTransactionInfoTax
object
The data for a tax transfer to the Tax Office or Customs Chamber.
6 properties
StetDebtorAccountReference
object
Information about the payer/debtor's account.
1 property
Balance
object
Relevant information associated with the monetary balance of an individual account.
4 properties
AddressInfo
object
The complete postal address of a party.
16 properties
AccountIdentifierGbDomestic
object
A domestic bank account in the UK.
2 properties
GetTransactionResponse
object
2 properties
1 required
PolishApiPayer
object
Information about the tax payer.
2 properties
ResourceExhaustedError
object
Resource exhausted. Too many requests.
2 properties
1 required
CzechApiAccountReference
object
The unique provider account identifier required under the Czech Standard for Open Banking.
2 properties
NextGenPsd2ReportExchangeRate
object
The currency exchange rate.
6 properties
Cma9AccountDetailsPartyType
string
The party type, in a coded form.
Cma9AccountDetailsAccountType
string
Specifies the type of account.
Error
object
The request does not have valid authentication credentials needed to perform the operation.
2 properties
inline_response_404
object
1 property
1 required
StandingOrderMetadataEntry
object
Additional fields returned by the bank at its option in response to your particular request. The presence and type of metadata are entirely dependent on the ba…
Cma9AccountDetails
object
Provider account details required under the CMA9 API standard .
11 properties
SlovakApiTransactionDetails
object
Provider transaction details required under the Slovak Banking API Standard .
4 properties
StandingOrderStatus
string
The current status of the standing order.
GetBalancesResponse
object
1 property
Cma9MerchantDetails
object
2 properties
StetAccountDetails
object
The provider account details required under the French PSD2 API standard .
7 properties
Money
object
The balance currency and value.
2 properties
2 required
CustomerDataCreditor
object
Specifies the legal identity information for the payee. This information is not required for settlement accounts.
2 properties
1 required
Domestic
object
A domestic bank account in the UK.
3 properties
AccountIdentifierPan
object
The Primary Account Number (PAN). The card identifier found on payment cards, such as credit cards and debit cards, as well as stored-value cards, gift cards a…
1 property
PolishApiTransactionInfoCard
object
The information about the card used in/for the transaction.
2 properties
PolishApiSocialSecurityPayer
object
The information associated with payer social security; i.e. , Polish Security Institution (ZUS).
3 properties
Transaction
object
Information about the requested transaction.
13 properties
7 required
GetAccountResponse
object
Operation completed successfully.
1 property
PolishApiSenderRecipient
object
Information about the recipient.
4 properties
PolishApiTypeOfRelation
string
The type of relation between the user and the account.
CreditorEndpoint
object
7 properties
PolishApiTransactionDetails
object
The provider transaction details required under the Polish API standard .
21 properties
GetTransactionsResponse
object
3 properties
1 required
StandingOrderToken
object
2 properties
PolishApiAccountHolderType
string
Specifies the type of account holder.
inline_response_501
object
1 property
1 required
TransactionType
string
Specifies the type of transaction.
bankId
string
The Token.io id of the bank where the consent is created. This field is required if the customer is not using Token.io's Hosted Pages for bank selection, i.e.…
NextGenPsd2AccountDetails
object
Provider account details required under the NextGenPSD2 standard .
6 properties
Iban
object
2 properties
ErrorWithCode
object
Error object providing details about the error.
2 properties
2 required
PolishApiBankAccountInfo
object
Specifies information about the bank itself.
2 properties
PolishApiTransactionDetails.AuxDataEntry
object
The bank-defined auxiliary data associated with the account.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Token.io 12
Other APIs Token.io publishes across the network.
Token.io JavaScript SDK
Token.io PHP SDK
Token.io C# SDK
Token.io Objective-C SDK
Token.io iOS Webview SDK
Token.io Android Webview SDK
Merchant Sample (Java)
Merchant Sample (JavaScript)
Bank Sample (Java)
Personal Finance Management Sample (Java)
Merchant Integration Workshop
token-io Account on File API
#Account
Where this information came from
This is an independent, third-party profile of token-io Accounts API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.