List accounts

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

List accounts for the given connection

Retrieve every account for the given connection

get

/api/v1/queries/connections/{token}/accounts

Authorizations

Path parameters

tokenstringrequired

Token to identify the connection

Responses

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.finlink.vumi.io/api/v1/queries/connections/{token}/accounts' \
  --header 'Authorization: Bearer JWT'

200

401

404

500

200

[
  {
    "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-03-12T04:23:57.805Z",
    "createdAt": "2025-03-12T04:23:57.805Z",
    "owners": [
      "CARLOS MATA GARCIA",
      "OSCAR MENDEZ VALLADARES"
    ]
  }
]

Successfully retrieved all accounts

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.