Browse
Article 9 legality assessment โ the applicable laws (Art 9(1)(h)), their adverse-media concerns, and the headline legality risk level/score.
Returns the latest legality assessment per plot, paginated and
filterable. All four response formats (application/json,
application/geo+json, application/x-ndjson, application/x-ndgeo+json)
are available via the Accept header โ see Response Formats.
EUDR-scope slug. These rows exist only for EUDR-processed locations. The endpoint is gated on
assessments:readlike every assessment read (it is not separately gated on an EUDR scope).
โถRequest
โถMethod & Path
GET /assessments/plots/legality
โถ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). |
This slug additionally supports:
| Filter | Type | Description |
|---|---|---|
filter[risk_level] | string (eq, in) | Adverse-media / legality risk level (e.g. low, medium, high). |
filter[risk_score_min] | numeric (eq) | Minimum risk score (inclusive). |
filter[risk_score_max] | numeric (eq) | Maximum risk score (inclusive). |
filter[category] | string (eq) | Only locations with an applicable law of this category (e.g. labour_rights). |
filter[has_adverse_media] | enum true/false (eq) | Whether at least one applicable law has a non-empty adverse-media concern. |
filter[media_relevance] | string (eq) | Match an adverse-media concern's relevance value. |
filter[since] | date (eq) | Only assessments with sco2_run_at on or after this date. |
โถSorting
?sort= keys (leading - = descending): since (default -since), risk_score, created_at.
โถResponse
- 200 โ Paginated list of legality assessments.
- 400 / 401 / 403 โ See Error Codes.
โถdata[] attributes
data[] attributesEvery assessment resource carries the shared identity / meta block (sourced
from the location + ingestion joins, not the assessment data):
| Field | Type | Description |
|---|---|---|
location_id | uuid | Type-specific location ID. |
location_type | facility | shed | plot | Underlying entity type. |
commodity | string | null | Commodity type. |
country_code | string | null | ISO 3166-1 alpha-2 country code. |
name | string | null | Normalised location name. |
geo | GeoJSON | null | Location geometry. |
sco2_run_at | ISO 8601 | null | Timestamp of the run that produced this assessment. |
asset_task_id | uuid | Ingestion task that linked this location. |
created_at | ISO 8601 | null | Creation timestamp. |
updated_at | ISO 8601 | null | Last update timestamp. |
Plus the Legality-specific attributes:
| Field | Type | Description |
|---|---|---|
applicable_laws | array | Applicable laws with adverse-media concerns (see nested shape below). |
legality_risk_score | number | null | Adverse-media / legality risk score. |
legality_risk_level | string | null | Adverse-media / legality risk level. |
legality_summary | string | null | LLM-generated legality risk summary. |
legality_adverse_media_summary | string | null | Adverse-media narrative behind the assessment. |
article10_summary | string | null | Article 10(2) criteria narrative (distinct from the Art 9 adverse-media summary). |
legality_raised_flag_count | number | null | Count of applicable laws whose red flag was raised. |
legality_red_flags | array | Per-law red-flag synthesis (raised/none + rationale). |
legality_sources | array | Grounded source citations supporting the assessment. |
โถNested shapes
applicable_laws[] items:
| Field | Type | Description |
|---|---|---|
ordinal | number | 1-based position within the location's laws. |
name | string | Law / regulation name. |
description | string | null | Law summary. |
category | string | null | Law category (e.g. labour_rights). |
jurisdiction | string | null | Issuing jurisdiction. |
citation | string | null | Citation / official URL. |
evidence_supplier_should_provide | string[] | Evidence the supplier should provide. |
adverse_media_concerns | array | { headline, source, published_at, relevance, url }. |
legality_red_flags[] items: { law, red_flag, rationale, source_url }.
legality_sources[] items: { title, url, publication_date, snippet, geographic_relevance, sentiment, risk_signal }.
For a row-per-law or row-per-concern view (paginated and filtered at the row level), use the flattener endpoints in this folder โ Applicable Laws and Adverse Media.
โถSample response
{
"meta": {
"page": 1,
"page_size": 1,
"total": 1,
"has_next": false
},
"links": {
"self": "/assessments/plots/legality"
},
"data": [
{
"type": "assessment",
"id": "3fad3b99-0000-0000-0000-000000000000",
"attributes": {
"location_id": "81895eee-e2bd-4b65-b75d-3c92110b5552",
"location_type": "plot",
"commodity": "palm",
"country_code": "BR",
"name": "Example Plot",
"legality_risk_level": "low",
"legality_risk_score": 0.12,
"legality_raised_flag_count": 0,
"applicable_laws": []
},
"links": {
"self": "/assessments/plots/81895eee-e2bd-4b65-b75d-3c92110b5552/legality"
}
}
]
}
Required scope:
assessments:read