# Holdings (by reporting entity)

Aggregate market-value holdings for a reporting entity over a date
range. Default output is one row per date for the entity as a whole;
`expand` breaks the totals down by portfolio, depository, instrument,
or instrument class.

## Endpoints

GET /v2/holdings/reporting-entities/:id
  Aggregated holdings for a reporting entity (date-range query).

GET /v3/instrument-holdings/reporting-entities/:id
  Per-instrument holdings (always includes `unitsInHolding`).

## Path params

  id (required) — Reporting-entity identifier.

## Attributes (`type: holding`)

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

## Relationships

  reportingEntity        (required) — The reporting entity the rows belong to.
  depository             (optional) — Present when `expand=depositories`.
  portfolio              (optional) — Present when `expand=portfolios`.
  instrument             (optional) — Present when `expand=instruments`.
  instrumentClass        (optional) — Present when `expand=instrumentClasses`.
  instrumentClassDetailed (optional) — Present when `expand=instrumentClassesDetailed`.

When `expand=depositories` is set, holdings without a depository can
be identified as the rows whose `relationships` object lacks
`depository`.