List Unaccounted Plots
List plots that satisfy the record's stored filter today but are not yet in the current version snapshot. Operationally: these are the plots that landed on the source asset_task after the version was cut and would qualify for inclusion if the filter were re-applied โ the trigger for cutting a v2.
โถDefinition
A plot is unaccounted for a record's current version v iff:
- It belongs to one of the asset tasks that fed
v. - It is visible to the caller (scoped to the caller's organization).
- It satisfies the record's filters โ i.e. the version's stored
filter_inputre-applied, plus the record's stampedcommodityandcountry_code. - It is not already in
v.
Step 3 is what distinguishes unaccounted from excluded. Re-applying the stored filter cleanly separates "added since snapshot, would qualify today" (returned here) from "existed at snapshot time but failed the filter" (correctly omitted).
Naming: this is not the same as the operator-driven
exclusions config. Excluded plots are intentional
removals managed via PUT /dds/:recordId/config; unaccounted plots
are an automatic, read-only signal.
โถPath params
| Param | Description |
|---|---|
recordId | DDS record id |
โถQuery params
| Name | Default | Notes |
|---|---|---|
page[number] | 1 | 1-indexed |
page[size] | 20 | max 100 |
โถResponse
| Field | Notes |
|---|---|
meta.count | Total unaccounted plots (mirrors attributes.unaccounted_plot_count on Get DDS Record, returned there with ?include=unaccounted_plot_count) |
meta.filters | The filters that determined inclusion: the version's filter_input plus the record's stamped commodity and country_code. Lets the caller render why each row was left out without a second round trip. |
data[].id | Plot UUID |
data[].attributes.commodity | Plot commodity (matches the record's stamped commodity) |
data[].attributes.country_code | ISO 3166-1 alpha-2 (matches the record's stamped country) |
data[].attributes.area_ha | Plot area in hectares; null when source data didn't supply it |
data[].attributes.producer_name | Producer name from the plot row; null when absent |
When the record has no current version yet (defensive), the response
is 200 with meta.count: 0, an empty data array, and
meta.filters.filter_input: {}.
โถErrors
| Status | Code | When |
|---|---|---|
| 401 | UNAUTHORIZED | Missing/invalid API key |
| 404 | NOT_FOUND | Record isn't visible to the caller |
| 500 | INTERNAL_SERVER_ERROR | Stored filter_input is unparseable (defensive โ create validates the filter before persisting) |
Required scope:
ingestions:read