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):

FilterTypeDescription
organization_iduuidOwning organization ID.
location_iduuidStaged location ID.
commodityenumCommodity type.
country_codeiso-countryISO 3166-1 alpha-2.
namestringLocation name.
tagstagsTags on linked entities.
created_atdatePer-org link creation timestamp.
country / admin_region / citystringNormalised location-parity fields.
facility_id / shed_id / plot_idstring / uuidUnderlying entity IDs.
assets.task_iduuidIngestion task ID.
assets.filenamestringSource filename from ingestion.
assets.data.*wildcardUser-uploaded source columns (e.g. filter[assets.data.CITY]=London).

Plus the row-level filters:

FilterTypeDescription
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_law rows.
  • 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:

FieldTypeDescription
ordinalnumber1-based position of this law within the location's laws.
namestringLaw / regulation name.
descriptionstring | nullLaw summary.
categorystring | nullLaw category (e.g. labour_rights, human_rights).
jurisdictionstring | nullIssuing jurisdiction.
citationstring | nullCitation / official URL.
evidence_supplier_should_providestring[]Evidence the supplier should provide for this law.

Required scope: assessments:read