List Excluded Plots
Plots in this specific version of the record that the operator has marked excluded. Each row carries any matching justification.
Same row shape as the record-level
/plots/excluded endpoint;
only the scope differs.
โถ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 | Accepted for parity with /plots; has no effect here, since every excluded plot may need a decision. |
โถResponse
See Record/plots/List Plots for the full
field reference. attributes.excluded is always true here.
โถExclusions across history
Exclusions are keyed by (record, plot) not (version, plot), so
the same plot is reported excluded in every historic version that
contained it. Mirrors what the package generator reads.
โถ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