---
title: "Retrieve the holdings for an account"
method: GET
path: "/accounts/{accountId}/holdings"
tags: ["holdings"]
---

# Retrieve the holdings for an account

`GET /accounts/{accountId}/holdings`

Requires **accounts:read** scope.

## Path parameters

- `accountId` string, uuid, required

## Response `200`

Successful Holdings Response

- object
  - `data` HoldingsValuation[]
    - `date` string, date, required — Date of the valuation
    - `items` object[], required
      - `id` string — The unique identity of the holding.
      - `codes` object[], required
        - `code` string
        - `type` 'ISIN' | 'SEDOL' | 'MEX'
      - `description` string, required
      - `quantity` number, required — The total number of units. This value reflects the quantity of the holding in its local currency context and is used to calculate the total value as unitPrice * quantity.
      - `total` object, required
        - `value` number, required — The total value of the holding in minor units of the currency (e.g. pence for GBP).
        - `currency` string, required — The currency of the total.
      - `unitPrice` object, required
        - `value` number, required — The price per unit in minor units of the holding. Provided by the holdings data source in its original currency.
        - `currency` string, required — The currency of the unit price.
      - `costBasis` number — In a one-off security purchase, the cost basis is the quantity acquired multiplied by the price paid per unit plus any commission. In the event the same position is acquired in different lots on different days at different prices, the sum total of the cost incurred is divided by the total units acquired to arrive at the average cost basis.
      - `currency` string — The currency of the holding
  - `links` Links
    - `next` string, uri — The url to retrieve the next page of results from
    - `prev` string, uri — The url to retrieve the previous page of results from
    - `self` string, uri, required — The url of the current resource(s)
  - `meta` object

## Other responses

- `401` — Unsuccessful Response - Not authorised - Missing authorization header - Invalid access Token
- `403` — Unsuccessful Response - Forbidden - Invalid scopes
- `404` — Unsuccessful Response - Resource Not found

---

[API](https://skmtc.net/moneyhub/apis/moneyhub-data-api.md) · [All operations](https://skmtc.net/moneyhub/apis/moneyhub-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moneyhub/moneyhub-data-api/revisions/f2eb965eb9af/schema)