Applicable Laws
Flattened legality view: one row per applicable law (Art 9(1)(h)), across all plots. Each row carries a 1-based ordinal that correlates it back to its parent law on the per-location Legality surface. Pagination and filters operate at the row level.
EUDR-scope slug. Legality rows exist only for EUDR-processed locations. Gated on
assessments:read.
โถRequest
โถMethod & Path
GET /assessments/plots/legality/applicable-laws
โถFilters
All read endpoints share the location-level and ingestion-trace filters
(filter[field]=condition:value โ see Query Parameters):
| Filter | Type | Description |
|---|---|---|
organization_id | uuid | Owning organization ID. |
location_id | uuid | Staged location ID. |
commodity | enum | Commodity type. |
country_code | iso-country | ISO 3166-1 alpha-2. |
name | string | Location name. |
tags | tags | Tags on linked entities. |
created_at | date | Per-org link creation timestamp. |
country / admin_region / city | string | Normalised location-parity fields. |
facility_id / shed_id / plot_id | string / uuid | Underlying entity IDs. |
assets.task_id | uuid | Ingestion task ID. |
assets.filename | string | Source filename from ingestion. |
assets.data.* | wildcard | User-uploaded source columns (e.g. filter[assets.data.CITY]=London). |
Plus the row-level filters:
| Filter | Type | Description |
|---|---|---|
filter[category] | string (eq) | Law category (row level). |
filter[risk_level] | string (eq, in) | Parent location's legality risk level. |
filter[since] | date (eq) | Only rows whose assessment has sco2_run_at on or after this date. |
โถSorting
?sort= keys: since (default -since), risk_score, created_at.
โถResponse
- 200 โ Paginated list of
applicable_lawrows. - 400 / 401 / 403 โ See Error Codes.
Each item is { "type": "applicable_law", "id", "attributes", "links" }, where id
is a synthetic composite key (<validation_id>:<ordinal>). Alongside the shared identity block
(location_id, location_type), each row carries:
| Field | Type | Description |
|---|---|---|
ordinal | number | 1-based position of this law within the location's laws. |
name | string | Law / regulation name. |
description | string | null | Law summary. |
category | string | null | Law category (e.g. labour_rights, human_rights). |
jurisdiction | string | null | Issuing jurisdiction. |
citation | string | null | Citation / official URL. |
evidence_supplier_should_provide | string[] | Evidence the supplier should provide for this law. |
Required scope:
assessments:read