List portfolios

Returns the list of every portfolio found in a connection, including inactive portfolios (if available at the financial entity).

List portfolios for the given connection

get

Retrieve every portfolio for the given connection

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

tokenstringRequired

Token to identify the connection

Responses

200

Successfully retrieved all portfolios

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

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

HTTPcURLJavaScriptPython

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

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "type": "STOCK_PORTFOLIO",
    "owners": [
      "CARLOS MATA GARCIA",
      "OSCAR MENDEZ VALLADARES",
      "MARTIN RICO MARTINEZ"
    ],
    "balance": 1,
    "currency": "EUR",
    "createdAt": "2026-01-26T11:23:14.483Z",
    "updatedAt": "2026-01-26T11:23:14.483Z"
  }
]

Portfolio types

You can find the following portfolio types when using our API:

Type	Description
MIX	A portfolio with investments of multiple types inside it
STOCK_PORTFOLIO	This portfolio holds only stock-related and fixed-income instruments (stocks, ETFs, bonds, and CFDs) and does not include any Funds or Pension Plans.
COMPOSITE_ASSETS_PORTFOLIO	A portfolio that only holds investments in Funds or Pension Plans. This can mean that it is a portfolio that only exist for a specific Fund or Pension Plan (some financial entities separate them that way), or that it can have multiple positions at the same type, but those positions can only be Funds or Pension Plans.
MANAGED	A portfolio which positions are managed by the financial institution. These types of portfolios might have limited information available.