Get Version

Fetch the full snapshot for a single version: every plot pinned at create time, the pinned assessment ids and plot_for_job_id per plot, the original filter expression, and the completeness counts.

Path params

ParamDescription
recordIdDDS record id
versionIdVersion id (must belong to recordId)

What's in the snapshot

FieldTypeSource
attributes.filter_inputobjectThe body filter that produced this snapshot at create time
attributes.completenessobjectLive aggregate over the version's plot rows
attributes.lifecycle_statusenumยง8.1 dashboard state โ€” see below
attributes.submitting_atstring | nullISO timestamp of the latest version.submit_started event (derived from the audit log)
attributes.submitted_atstring | nullISO timestamp of the latest version.submitted / version.marked_submitted event (derived from the audit log)
attributes.traces_statementsarrayThe TRACES statement(s) that filed this version (EPO-1816). Empty until filed; 1..N when an oversized DDS split across statements. Each item: { statement_index, reference_number, verification_number, dds_uuid } (issued values are null until TRACES returns them async). Replaces the former scalar traces_reference.

lifecycle_status โ€” the dashboard verdict

Seven-value enum derived from the audit log + TRACES round-trip status + the staleness flag. Distinct from the report builder's computed_status.status:

ConceptFieldValuesAudience
Audit-log factcomputed_status.status on report responsesdraft / submitting / submitted / manually_submitted / submission_failedReconcilers โ€” drives flat_matches / discrepancies
Dashboard verdictlifecycle_status on read responses (this field)draft / awaiting_submission / submitting / submitted / accepted / rejected / staleUIs โ€” what the operator sees

See Get Audit Record Summary for the value-by-value reference and the rationale behind keeping two enums. | attributes.plots[].plot_id | uuid | Plot identifier | | attributes.plots[].asset_task_id | uuid | Parent task at snapshot time | | attributes.plots[].plot_for_job_id | uuid | null | EUDR-valid + CCDC-first deforestation metric pin (null when no valid metric exists) | | attributes.plots[].core_validation_id | uuid | null | The assessment pinned for core | | attributes.plots[].art9_validation_id | uuid | null | โ€ฆ art9 | | attributes.plots[].art10_validation_id | uuid | null | โ€ฆ art10 | | attributes.plots[].hazard_validation_id | uuid | null | โ€ฆ hazard | | attributes.plots[].infrastructure_validation_id | uuid | null | โ€ฆ infrastructure |

Every *_validation_id references a pinned assessment. Use the existing assessment endpoints on the location to read the underlying payload. Every plot_for_job_id is the stable handle of the deforestation detection job pinned for that plot.

Performance

All plot rows for a version are returned in a single response โ€” no pagination on the inner list. A v1 record is bounded to a single homogeneous (commodity, country) scope so the plot count is practical. If pagination becomes necessary we'll add a paginated sub-endpoint rather than streaming this one.

Errors

StatusCodeWhen
401UNAUTHORIZEDMissing/invalid API key
404NOT_FOUNDRecord or version isn't visible to the caller

Required scope: ingestions:read