Adverse Media
Flattened legality view: one row per adverse-media concern, across all facilities. 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/facilities/legality/adverse-media
โถ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) | Parent law category (row level). |
filter[risk_level] | string (eq, in) | Parent location's legality risk level. |
filter[media_relevance] | string (eq) | Match the concern's relevance value (row 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
adverse_media_concernrows. - 400 / 401 / 403 โ See Error Codes.
Each item is { "type": "adverse_media_concern", "id", "attributes", "links" }, where id
is a synthetic composite key (<validation_id>:<law_ordinal>:<concern_idx>). Alongside the shared identity block
(location_id, location_type), each row carries:
| Field | Type | Description |
|---|---|---|
law_ordinal | number | Ordinal of the parent applicable law (for correlation). |
law_name | string | Name of the parent applicable law. |
category | string | null | Category of the parent applicable law. |
headline | string | Adverse-media concern headline. |
source | string | null | Publication / source name. |
published_at | string | null | Publication date. |
relevance | string | null | Relevance of the concern. |
url | string | null | Source URL. |
Required scope:
assessments:read