---
title: "List positions"
method: GET
path: "/financial-data/v2beta/portfolios/{pid}/holdings/{hid}/positions"
tags: ["Investments"]
---

# List positions

`GET /financial-data/v2beta/portfolios/{pid}/holdings/{hid}/positions`

Returns a list of positions for a specific holding. For further details on Pagination, see general section above.

## Path parameters

- `pid` string, required
- `hid` string, required

## Query parameters

- `limit` integer
- `token` string

## Response `200`

List of positions.

- object
  - `items` Position[], required — A list of resources.
    - `id` string, required — Unique resource identifier.
    - `holdingId` string, required — Unique resource identifier.
    - `organizationId` string, required — Unique resource identifier for an Organization.
    - `timestamp` string, date-time, required — Timestamp of when the position was recorded. This timestamp is reported in UTC and thus the date component of this timestamp may be different than `localDate`.
    - `localDate` string, date, required — `full-date` notation as defined by [RFC 3339, section 5.6](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), for example, `2017-07-21`.
    - `maturityDate` string, date — `full-date` notation as defined by [RFC 3339, section 5.6](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), for example, `2017-07-21`.
    - `type` 'MONEY_MARKET_FUND' | 'FIXED_TERM_FUND' | 'EXCHANGE_TRADED_FUND' | 'GOVERNMENT_BOND' | 'CORPORATE_BOND' | 'MUTUAL_FUND', required — The type of holding.
    - `nav` Amount
      - `currency` string, required — Three-letter ISO 4217 currency code.
      - `stringValue` string, required — A string representation of the amount value. This will be a decimal number if the currency has decimals. The number is not formatted for display purposes (e.g. with locale specific thousand separator) and always contains the dot `.` character as decimal separator.
      - `value` integer, required — The amount value as an integer (int64) represented in currency minor units (e.g. 15.02 EUR is represented as the value 1502).
    - `scaledNav` ScaledAmount
      - `currency` string, required — Three-letter ISO 4217 currency code.
      - `value` integer, required — The amount value as a scaled integer (int64). The number of decimal places is given by the `decimals` field, not by the currency. E.g. value=10004 with decimals=4 represents 1.0004.
      - `decimals` integer, required — The number of decimal places in `value`.
      - `stringValue` string, required — A string representation of the amount value as a decimal number.
    - `shares` number, double — Number of shares held
    - `totalValue` Amount, required
      - `currency` string, required — Three-letter ISO 4217 currency code.
      - `stringValue` string, required — A string representation of the amount value. This will be a decimal number if the currency has decimals. The number is not formatted for display purposes (e.g. with locale specific thousand separator) and always contains the dot `.` character as decimal separator.
      - `value` integer, required — The amount value as an integer (int64) represented in currency minor units (e.g. 15.02 EUR is represented as the value 1502).
    - `yield` number, double — Annualized yield of the fund
    - `wam` number, double — Weighted Average Maturity in days
    - `wal` number, double — Weighted Average Life in days
    - `wla` number, double — Weekly Liquid Assets (%)
    - `nominal` Amount
      - `currency` string, required — Three-letter ISO 4217 currency code.
      - `stringValue` string, required — A string representation of the amount value. This will be a decimal number if the currency has decimals. The number is not formatted for display purposes (e.g. with locale specific thousand separator) and always contains the dot `.` character as decimal separator.
      - `value` integer, required — The amount value as an integer (int64) represented in currency minor units (e.g. 15.02 EUR is represented as the value 1502).
    - `fundAum` Amount
      - `currency` string, required — Three-letter ISO 4217 currency code.
      - `stringValue` string, required — A string representation of the amount value. This will be a decimal number if the currency has decimals. The number is not formatted for display purposes (e.g. with locale specific thousand separator) and always contains the dot `.` character as decimal separator.
      - `value` integer, required — The amount value as an integer (int64) represented in currency minor units (e.g. 15.02 EUR is represented as the value 1502).
    - `rate` number, double — Bond coupon rate expressed as a decimal fraction, e.g. 0.0425 for 4.25%
    - `totalPurchasePrice` Amount
      - `currency` string, required — Three-letter ISO 4217 currency code.
      - `stringValue` string, required — A string representation of the amount value. This will be a decimal number if the currency has decimals. The number is not formatted for display purposes (e.g. with locale specific thousand separator) and always contains the dot `.` character as decimal separator.
      - `value` integer, required — The amount value as an integer (int64) represented in currency minor units (e.g. 15.02 EUR is represented as the value 1502).
    - `version` integer, required — Resource version. Starts at value `1` when the resource is created and increases by one for each successive update.
    - `etag` string, required — [ETag](https://en.wikipedia.org/wiki/HTTP_ETag) based on the resource version. This can be passed along in `If-Match` HTTP header when updating a resource to perform a conditional update.
  - `nextToken` string, required — Pagination token for next page. The value will be a non-empty string if there are more resources to be fetched. The value will be an empty string if there are no more resources to be fetched.
  - `token` string, required — The pagination token that was used for this request. The value will be an empty string if no `token` query parameter was provided with the request.
  - `limit` integer, required — The page limit that was used for this request.

## Other responses

- `400` — Bad request.
- `404` — Resource not found.

---

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