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:

  1. It belongs to one of the asset tasks that fed v.
  2. It is visible to the caller (scoped to the caller's organization).
  3. It satisfies the record's filters โ€” i.e. the version's stored filter_input re-applied, plus the record's stamped commodity and country_code.
  4. 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

ParamDescription
recordIdDDS record id

Query params

NameDefaultNotes
page[number]11-indexed
page[size]20max 100

Response

FieldNotes
meta.countTotal unaccounted plots (mirrors attributes.unaccounted_plot_count on Get DDS Record, returned there with ?include=unaccounted_plot_count)
meta.filtersThe 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[].idPlot UUID
data[].attributes.commodityPlot commodity (matches the record's stamped commodity)
data[].attributes.country_codeISO 3166-1 alpha-2 (matches the record's stamped country)
data[].attributes.area_haPlot area in hectares; null when source data didn't supply it
data[].attributes.producer_nameProducer 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

StatusCodeWhen
401UNAUTHORIZEDMissing/invalid API key
404NOT_FOUNDRecord isn't visible to the caller
500INTERNAL_SERVER_ERRORStored filter_input is unparseable (defensive โ€” create validates the filter before persisting)

Required scope: ingestions:read