List accounts

Returns the list of every account found in a connection, including inactive portfolios.

List accounts for the given connection

get

Retrieve every account for the given connection

Authorizations

Path parameters

tokenstringRequired

Token to identify the connection

Responses

200

Successfully retrieved all accounts

application/json

401

Invalid credentials

application/json

404

Connection not found with the given token for the current app

application/json

500

Internal server error

application/json

get

HTTPcURLJavaScriptPython

GET /api/v1/queries/connections/{token}/accounts HTTP/1.1
Host: api.finlink.vumi.io
Authorization: Bearer JWT
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "portfolio": "123e4567-e89b-12d3-a456-426614174000",
    "iban": "text",
    "type": "CASH_ACCOUNT",
    "alias": "text",
    "balance": 1,
    "currency": "EUR",
    "updatedAt": "2025-05-16T10:33:53.346Z",
    "createdAt": "2025-05-16T10:33:53.346Z",
    "owners": [
      "CARLOS MATA GARCIA",
      "OSCAR MENDEZ VALLADARES"
    ]
  }
]

Account types

You will find the following account types when using our API:

Type	Description
CASH_ACCOUNT*	Accounts which purpose is not strictly related to investing. They typically can have payments associated to them or other types of bank products.
OTHER	Accounts directly associated to portfolios. These accounts exist just to hold information about the liquidity in a portfolio. We only return these type of accounts when the entity is of type BROKER.

*Cash accounts are currently not returned unless you have a valid License with Banco de España. We are actively requesting ours and should be ready early 2025.