# Instrument holdings (by reporting entity)

Per-instrument holdings for a reporting entity over a date range —
includes `unitsInHolding` (the number of units owned), which the
aggregated `/v2/holdings/...` endpoint does not.

## Endpoints

GET /v3/instrument-holdings/reporting-entities/:id
  Per-instrument holdings for a reporting entity (date-range query).

## Path params

  id (required) — Reporting-entity identifier.

## Attributes (`type: instrument-holding`)

  date            (string, ISO 8601) — Date the value holds.
  ccyCode         (string)            — ISO 4217 reporting currency.
  marketValue     (number)            — Market value of the holding.
  unitsInHolding  (number)            — Units of the instrument owned.

## Relationships

  reportingEntity         (required)
  portfolio               (required)
  instrument              (required)
  depository              (optional)
  instrumentClass         (optional)
  instrumentClassDetailed (optional)