Funds

View as Markdown
Investment funds held at the institution. Each holding carries the fund and its identifiers, the units held, the net asset value used, the valuation and the result. Field by field in [Investments](/guides/data-models/banking/investments). <Note title="Requires the `funds_read` feature"> Features are chosen when the execution **starts**, not here. An execution that did not ask for `funds_read` answers `204`, and the only way to get the data is to run another one. </Note> | Status | Meaning | | :--- | :--- | | `200` | The holdings. | | `202` | `feature_not_ready` — `funds_read` is still running. **Only this family waits**: the ones that already closed answer now. | | `204` | The execution never asked for `funds_read`. No body. | | `404` | No execution with that id for your application, or it has been deleted. | <Note> **Server to server only.** This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read. </Note>

Authentication

X-APP-SECRETstring
Application Secret

Path parameters

execution_idstringRequiredformat: "object-id"
The execution, as the acceptance response returned it.

Response

200 OK
Fund positions, with their identifiers, units, valuation and the account they hang from.

An empty list is an answer, not a gap: the feature ran and the source reported none.

idstringformat: "object-id"

Product ID for the current execution. Note: it may change between executions.

product"investment_asset"
sub_familyenum
fetch_datestringformat: "datetime"
Date this product was fetched
accountobject
Account identifier
customer_segmentenum
product_namestring
Product name
contractobjectOptional
Contract if present
product_aliasstringOptional
Product alias
product_descriptionstringOptional
Product Description
isinstringOptional
ISIN code
tickerstringOptional
Ticker
marketstringOptional
Market
categorystringOptional
Category
unit_priceobjectOptional
Unit price
quantitystringOptionalformat: "number"Defaults to nan
The number of units of a financial instrument held by the account.
valuationobjectOptional
The monetary value of a financial instrument held by the account.
valuation_datedateOptional
Valuation date
appreciationobjectOptional
The monetary value of the appreciation of a financial instrument held by the account.
performanceobjectOptional
Performance

Errors

404
Not Found Error
422
Unprocessable Entity Error