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
get
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": "ES0000000000000000000000",
    "type": "CASH_ACCOUNT",
    "alias": "text",
    "balance": 1,
    "currency": "EUR",
    "updatedAt": "2025-06-26T11:33:56.478Z",
    "createdAt": "2025-06-26T11:33:56.478Z",
    "owners": [
      "CARLOS MATA GARCIA",
      "OSCAR MENDEZ VALLADARES",
      "MARTIN RICO MARTINEZ"
    ]
  }
]

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.

Last updated