List Unaccounted Plots
Plots that satisfy this specific version's stored filter_input
(plus the record's stamped commodity + country) but are not in
this version's snapshot.
Operationally: plots that landed on the source asset_task after this
version was cut and would qualify if :versionId's filter were
re-applied today. For the record's latest version that's the
classic "should we cut a v2?" trigger; for an older version it's
the audit trail of what's been added since that historic submission.
Same response shape as the record-level
/plots/unaccounted
endpoint โ meta.filters echoes the filters that determined
inclusion (this version's filter_input + the record's stamped
commodity / country).
โถPath params
| Param | Description |
|---|---|
recordId | DDS record id |
versionId | DDS record version id |
โถQuery params
| Name | Default | Notes |
|---|---|---|
page[number] | 1 | 1-indexed |
page[size] | 20 | max 100 |
โถ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 |
| 500 | INTERNAL_SERVER_ERROR | Stored filter_input is unparseable (defensive โ create validates the filter before persisting) |
Required scope:
ingestions:read