List Plots
Plots in this specific version of the record that the operator has not excluded โ i.e. the set the package generator would emit if this version were re-rendered today.
Same row shape as the record-level
/plots endpoint; only the scope
differs (this version, vs the current version).
โถPath params
| Param | Description |
|---|---|
recordId | DDS record id |
versionId | DDS record version id |
โถQuery params
| Name | Default | Notes |
|---|---|---|
page[number] | 1 | 1-indexed. Also accepted as page; capped at 10,000. |
page[size] | 20 | max 100. Also accepted as page_size; over-large values clamp. |
filter[plot_resolution] | โ | Narrow to a review state โ eq:pending_review, or in:<a>,<b>. See Record/plots/List Plots. |
filter[needs_resolution] | false | true drops compliant plots with no justification. See Record/plots/List Plots. |
โถResponse
See Record/plots/List Plots for the full
field reference. attributes.excluded is always false here.
โถExclusions across history
Exclusions and justifications attach to the dds_record, not the
version, so they apply uniformly across history. A plot marked
excluded today is treated as excluded in every version that
contained it.
โถErrors
| Status | Code | When |
|---|---|---|
| 401 | UNAUTHORIZED | Missing/invalid API key |
| 404 | NOT_FOUND | Record isn't visible OR version doesn't belong to the record |
Required scope:
ingestions:read