Adverse Media

Flattened legality view: one row per adverse-media concern, 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/adverse-media

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)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_concern rows.
  • 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:

FieldTypeDescription
law_ordinalnumberOrdinal of the parent applicable law (for correlation).
law_namestringName of the parent applicable law.
categorystring | nullCategory of the parent applicable law.
headlinestringAdverse-media concern headline.
sourcestring | nullPublication / source name.
published_atstring | nullPublication date.
relevancestring | nullRelevance of the concern.
urlstring | nullSource URL.

Required scope: assessments:read