Token.io

token-io Accounts API

These endpoints provide authorized access to an authenticated user's account information.

GitHub OpenAPI

Operations 25

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /accounts/{bankAccountId}/balance Return an account balance as the bank integration · Get account balance #
Ask an LLM
“As a bank integrating with Token.io, what do I return when asked for an account balance?”
“Which consent and TPP headers accompany a bank-side balance request?”
Tell an agent
Return the bank-side balance for bank account {bank_account_id} under consent {consent_id}.
Serve the current balance of bank account {bank_account_id} to TPP {tpp_id}.
GET /accounts/{bankAccountId}/transactions Return account transactions as the bank integration · Get account transactions #
Ask an LLM
“On the bank side, how are transactions for an account paged by limit and offset?”
“Can the bank integration filter returned transactions by start and end date?”
Tell an agent
Return bank-side transactions for bank account {bank_account_id} from {start_date} to {end_date}.
Serve {limit} transactions for bank account {bank_account_id} under consent {consent_id}.
GET /accounts/{bankAccountId}/transactions/{transactionId} Return one transaction as the bank integration · Get account transactions for given bank #
Ask an LLM
“As the bank, how do I answer a request for one transaction by its id?”
“Which ids does the bank-side single-transaction lookup need?”
Tell an agent
Return bank-side transaction {transaction_id} for bank account {bank_account_id}.
Serve transaction {transaction_id} of bank account {bank_account_id} to account holder {holder_id}.
GET /accounts/{bankAccountId} Return a bank account as the bank integration · Get account #
Ask an LLM
“What does the bank integration return when a TPP retrieves one bank account?”
“Can the bank-side account lookup be scoped to a specific consent id?”
Tell an agent
Return bank-side details for bank account {bank_account_id}.
Serve bank account {bank_account_id} under consent {consent_id}.
DELETE /accounts/{bankAccountId} Unlink a bank account when the user disconnects · Delete account #
Ask an LLM
“What happens on the bank side when a user unlinks their account at a TPP?”
“Can a customer's account link be removed after they disconnect it from an app?”
Tell an agent destructive · confirm first
Unlink bank account {bank_account_id} because the user disconnected it.
Delete the account link for bank account {bank_account_id}.
GET /accounts List all bank accounts shared under a consent · Get information for all accounts #
Ask an LLM
“Which bank accounts has a user shared with me through their account-information consent?”
“Can I see every account a customer linked in one call once they have granted access?”
Tell an agent
List every bank account covered by access token {token_id}.
Show all linked accounts for consent {token_id}, passing the customer's IP {ip}.
GET /accounts/{accountId} Get details for one consented bank account · Get account information #
Ask an LLM
“What details can I pull for a single bank account a user shared with me?”
“Is it possible to look up just one linked account instead of the whole list?”
Tell an agent
Get the details of account {account_id} under access token {token_id}.
Fetch account information for {account_id} using consent {token_id}.
GET /account-balance Get balances for several consented accounts · Get account balances #
Ask an LLM
“Can I fetch balances for multiple linked bank accounts in a single request?”
“What's the quickest way to see balances across all accounts a user shared with me?”
Tell an agent
Get balances for accounts {account_ids} under access token {token_id}.
Show the balances of every account covered by consent {token_id}.
GET /accounts/{accountId}/balance Get the balance of one consented account · Get an account balance #
Ask an LLM
“How much money is in a specific account a customer linked through open banking?”
“Can I check the current and available balance for one shared account?”
Tell an agent
Get the balance of account {account_id} under access token {token_id}.
Check how much is in linked account {account_id} with consent {token_id}.
GET /accounts/{accountId}/standing-orders List standing orders on a consented account · Get information for all standing orders #
Ask an LLM
“Which standing orders are set up on a bank account a user shared with me?”
“Can I page through a customer's recurring standing orders once they consent?”
Tell an agent
List the first {limit} standing orders on account {account_id} under access token {token_id}.
Show standing orders for account {account_id}, {limit} per page, starting at offset {offset}, with consent {token_id}.
GET /accounts/{accountId}/standing-orders/{standingOrderId} Get one standing order on a consented account · Get standing order information #
Ask an LLM
“What are the details of one particular standing order in a user's account?”
“Can I look up a single standing order by its id?”
Tell an agent
Get standing order {standing_order_id} on account {account_id} under access token {token_id}.
Show the payee and schedule of standing order {standing_order_id} using consent {token_id}.
GET /accounts/{accountId}/transactions List transactions on a consented account · Get account transactions #
Ask an LLM
“What transactions went through a bank account a customer shared with me?”
“Can I limit a user's transaction history to a date range?”
Tell an agent
List the last {limit} transactions on account {account_id} under access token {token_id}.
Show transactions on account {account_id} between {start_date} and {end_date}, {limit} per page, with consent {token_id}.
GET /accounts/{accountId}/transaction/{transactionId} Get one transaction on a consented account · Get transaction information #
Ask an LLM
“Can I pull the details of a single transaction from a user's linked account?”
“What information is returned for one specific bank transaction?”
Tell an agent
Get transaction {transaction_id} on account {account_id} under access token {token_id}.
Look up transaction {transaction_id} with consent {token_id}.
GET /v2/accounts List accounts through the v2 data access API · Data access gateway service get accounts #
Ask an LLM
“Is there a v2 endpoint that lists every account I can access?”
“Where do I get the account list in the newer v2 data access API?”
Tell an agent
List all accounts using the v2 data access API.
Show every account available to me in data access v2.
GET /v2/accounts/{accountId} Get one account through the v2 data access API · Data access gateway service get account #
Ask an LLM
“How can I get a single account's details from the v2 data access API?”
“Does the v2 data access API let me fetch one account by id?”
Tell an agent
Get account {account_id} from the v2 data access API.
Fetch v2 account details for {account_id}.
GET /v2/accounts/{accountId}/balances Get account balances through the v2 data access API · Data access gateway service get balances #
Ask an LLM
“Which v2 endpoint returns the balances of one account?”
“Can I read an account's balances from the v2 data access API?”
Tell an agent
Get the balances of account {account_id} from the v2 data access API.
Show v2 balances for account {account_id}.
GET /v2/accounts/{accountId}/transactions List account transactions through the v2 data access API · Data access gateway service get transactions #
Ask an LLM
“Can I filter v2 account transactions by start and end date?”
“What does the v2 data access API return for an account's transaction history?”
Tell an agent
List v2 transactions for account {account_id} from {start_date} to {end_date}.
Get {limit} v2 transactions for account {account_id} starting at offset {offset}.
GET /accounts/{accountId}/direct-debits List direct debits on a consented account · Retrieve information about all direct debits #
Ask an LLM
“Which direct debits are active on a bank account a user shared with me?”
“Can I page through all of a customer's direct debit mandates?”
Tell an agent
List direct debits on account {account_id}.
Show {limit} direct debits on account {account_id} starting at offset {offset}.
GET /accounts/{accountId}/direct-debits/{directDebitId} Get one direct debit on a consented account · Retrieve direct debit details #
Ask an LLM
“What are the details of a specific direct debit on a customer's account?”
“Can I look up a single direct debit mandate by its id?”
Tell an agent
Get direct debit {direct_debit_id} on account {account_id}.
Show who collects direct debit {direct_debit_id} from account {account_id}.
PUT /accounts/{accountId}/funds-confirmation Check an account has enough funds for an amount · Confirm available funds #
Ask an LLM
“Can I check whether a user's account has enough money before I charge them?”
“Is there a funds confirmation check for a specific amount on a linked account?”
Tell an agent
Confirm account {account_id} has {amount} available.
Check whether account {account_id} can cover a payment of {amount}.
GET /accounts/{accountId}/scheduled-payments List scheduled payments on a consented account · Retrieve information about all scheduled payments #
Ask an LLM
“What future-dated payments are scheduled on a customer's bank account?”
“Can I see scheduled payments within a date window?”
Tell an agent
List scheduled payments on account {account_id}.
Show scheduled payments on account {account_id} between {start_date} and {end_date}.
GET /accounts/{accountId}/scheduled-payments/{scheduledPaymentId} Get one scheduled payment on a consented account · Retrieve scheduled payment details #
Ask an LLM
“Can I look up one scheduled payment to see when and how much it will pay?”
“What details come back for a single scheduled payment?”
Tell an agent
Get scheduled payment {scheduled_payment_id} on account {account_id}.
Show the date and amount of scheduled payment {scheduled_payment_id} on account {account_id}.
GET /accounts/{accountId}/transfer-destinations Get details to pay into a consented account · Get transfer destination #
Ask an LLM
“What account details do I need to send money into a user's linked account?”
“Can I resolve a shared account into payment destination details like sort code or IBAN?”
Tell an agent
Get transfer destination details for account {account_id}.
Resolve account {account_id} into details I can pay into.
GET /trusted-beneficiaries List a user's trusted beneficiaries · Retrieve information about all trusted beneficiaries #
Ask an LLM
“Who has a customer marked as trusted beneficiaries at their bank?”
“Can I page through all trusted payees a user has consented to share?”
Tell an agent
List my customer's trusted beneficiaries.
Show {limit} trusted beneficiaries starting at offset {offset}.
GET /trusted-beneficiaries/{beneficiaryId} Get one trusted beneficiary · Retrieve trusted beneficiary details #
Ask an LLM
“What details are stored for a single trusted beneficiary?”
“Can I look up one trusted payee by its beneficiary id?”
Tell an agent
Get trusted beneficiary {beneficiary_id}.
Show the account details of trusted beneficiary {beneficiary_id}.

Documentation

📖
Documentation
https://docs.token.io/products/tpp/api/reference
📖
GettingStarted
https://docs.token.io/products/tpp

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/openapi/token-io-accounts-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-schema/token-io-payment-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-schema/token-io-vrp-consent-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-schema/token-io-account-schema.json

Other Resources

🔗
Reference
https://reference.token.io/
🔗
OpenAPISource
https://docs.token.io/_bundle/products/tpp/api/reference/index.yaml
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/json-ld/token-io-context.jsonld

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/token-io:token-io-accounts-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

token-io-accounts-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Token Io Accounts API
  version: '1.0'
  description: 'Operations tagged accounts across 3 of this provider''s published API definitions: token-io-bank-integration-openapi.json, token-io-openapi.yml, token-io-rest-api-swagger.json. Each path carries the servers of the definition it was published in.'
servers:
- url: /
- url: https://api.token.io
- url: https://api.token.io/v1
tags:


# --- truncated at 32 KB (212 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/token-io/refs/heads/main/openapi/token-io-accounts-api-openapi.yml