---
title: "Get holding activity"
method: GET
path: "/financial-data/v2beta/portfolios/{pid}/holdings/{hid}/activities/{id}"
tags: ["Investments"]
---

# Get holding activity

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

Retrieve a specific holding activity.

## Path parameters

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

## Response `200`

Holding activity.

- HoldingActivity
  - `id` string, required — Unique resource identifier.
  - `organizationId` string, required — Unique resource identifier for an Organization.
  - `portfolioId` string, required — Unique resource identifier.
  - `holdingId` string, required — Unique resource identifier.
  - `date` 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`.
  - `tradeDate` 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`.
  - `amount` 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).
  - `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 traded
  - `type` 'PURCHASE' | 'REDEEM' | 'DIVIDEND', required — The type of the activity on the holding.
  - `created` string, date-time, required — Time at which the resource was created.
  - `updated` string, date-time, required — Time at which the resource was last updated.
  - `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.
  - `metadata` Metadata, nullable — Metadata is a `string-string` key-value container that can be used to store information known at the time of resource creation. This can be retrieved later on, for instance when a payment or expected transaction is reconciled with the booked transaction on the bank statement. Metadata can have at most 20 entries. Keys may have a maximum length of 64 chars and values a maximum length of 512 chars. By default, this field is optional. It is possible to make it required in the Atlar Dashboard by visiting the [Metadata keys page](https://app.atlar.com/metadata-keys). Requirement rules can be specified per API resource. Both the Dashboard and the API will then enforce these rules and give validation errors when the required fields are not set.

## 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)