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
| Param | Description |
|---|---|
recordId | DDS record id |
versionId | Version id (must belong to recordId) |
โถWhat's in the snapshot
| Field | Type | Source |
|---|---|---|
attributes.filter_input | object | The body filter that produced this snapshot at create time |
attributes.completeness | object | Live aggregate over the version's plot rows |
attributes.lifecycle_status | enum | ยง8.1 dashboard state โ see below |
attributes.submitting_at | string | null | ISO timestamp of the latest version.submit_started event (derived from the audit log) |
attributes.submitted_at | string | null | ISO timestamp of the latest version.submitted / version.marked_submitted event (derived from the audit log) |
attributes.traces_statements | array | The 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
lifecycle_status โ the dashboard verdictSeven-value enum derived from the audit log + TRACES round-trip
status + the staleness flag. Distinct from the report builder's
computed_status.status:
| Concept | Field | Values | Audience |
|---|---|---|---|
| Audit-log fact | computed_status.status on report responses | draft / submitting / submitted / manually_submitted / submission_failed | Reconcilers โ drives flat_matches / discrepancies |
| Dashboard verdict | lifecycle_status on read responses (this field) | draft / awaiting_submission / submitting / submitted / accepted / rejected / stale | UIs โ 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
| Status | Code | When |
|---|---|---|
| 401 | UNAUTHORIZED | Missing/invalid API key |
| 404 | NOT_FOUND | Record or version isn't visible to the caller |
Required scope:
ingestions:read