# Snapshot object

Returned by [`POST /screener/institutional-holdings`](/documents/post-screenerinstitutional-holdings.md) (as `matches[]`, with `cik` and `name`) and [`POST /ownership/institutional-holdings/manager-history`](/documents/post-ownershipinstitutional-holdingsmanager-history.md) (as `quarters[]`, without them, plus `quarter`). One row = one manager × one calendar quarter, after amendments are merged.

| Field | Meaning |
|-------|---------|
| `cik`, `name` | The filing manager. Screener rows only. |
| `period` | Calendar quarter end the report covers. |
| `quarter` | Manager-history rows only: the `YYYYQn` label of `period`, as taken by the portfolio endpoint; `unknown` when `period` is not a calendar quarter end. |
| `filing_date`, `accession` | The filing this quarter's data comes from. |
| `is_combination_report` | `true` = 13F COMBINATION REPORT (the filer also reports holdings managed by other managers), `false` = 13F HOLDINGS REPORT. |
| `confidential` | The quarter carries confidential-treatment holdings. |
| `is_amended` | Amendments were merged into this quarter. The full archive is on the portfolio endpoint's quarter header. |
| `unit_multiplier` | `1`, or the whole-quarter unit-correction multiplier applied to the filed values. When it is not `1`, `unit_multiplier_reason` (`corrected_error` or `pre2023_rule`) is present; the key is omitted when null. |
| `total_positions_value` | Total value of the stock holdings, USD. |
| `total_derivatives_notional` | Total notional of the option holdings, USD. |
| `cover_table_value` | The cover-page total as filed, verbatim. |
| `positions_count`, `derivatives_count` | Live stock / option rows in the quarter. |
| `portfolio_value_qoq_pct` | Quarter-over-quarter change of `total_positions_value`, percent. |
| `top1_security_pct`, `top10_security_pct` | Portfolio share of the largest / ten largest stock holdings, percent (stock holdings only). |
| `est_turnover` | Estimated traded value versus the prior quarter, USD. |
| `activity_counts` | Map of row activity → count: `NEW`, `ADD`, `REDUCE`, `HOLD`, `SOLD_OUT`, `CUSIP_CHANGE`. |
| `sec_url` | The URL opens the filing's EDGAR index page; see the files listed there for full details. |

A quarter with **no prior filed quarter** to compare against has null `portfolio_value_qoq_pct`, `est_turnover` and `activity_counts`.

Quarters marked `confidential` in the returned result are also flagged in `_warnings`.
