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 facility, 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:read like every assessment read (it is not separately gated on an EUDR scope).

Request

Method & Path

GET /assessments/facilities/legality

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

This slug additionally supports:

FilterTypeDescription
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

Every assessment resource carries the shared identity / meta block (sourced from the location + ingestion joins, not the assessment data):

FieldTypeDescription
location_iduuidType-specific location ID.
location_typefacility | shed | plotUnderlying entity type.
commoditystring | nullCommodity type.
country_codestring | nullISO 3166-1 alpha-2 country code.
namestring | nullNormalised location name.
geoGeoJSON | nullLocation geometry.
sco2_run_atISO 8601 | nullTimestamp of the run that produced this assessment.
asset_task_iduuidIngestion task that linked this location.
created_atISO 8601 | nullCreation timestamp.
updated_atISO 8601 | nullLast update timestamp.

Plus the Legality-specific attributes:

FieldTypeDescription
applicable_lawsarrayApplicable laws with adverse-media concerns (see nested shape below).
legality_risk_scorenumber | nullAdverse-media / legality risk score.
legality_risk_levelstring | nullAdverse-media / legality risk level.
legality_summarystring | nullLLM-generated legality risk summary.
legality_adverse_media_summarystring | nullAdverse-media narrative behind the assessment.
article10_summarystring | nullArticle 10(2) criteria narrative (distinct from the Art 9 adverse-media summary).
legality_raised_flag_countnumber | nullCount of applicable laws whose red flag was raised.
legality_red_flagsarrayPer-law red-flag synthesis (raised/none + rationale).
legality_sourcesarrayGrounded source citations supporting the assessment.

Nested shapes

applicable_laws[] items:

FieldTypeDescription
ordinalnumber1-based position within the location's laws.
namestringLaw / regulation name.
descriptionstring | nullLaw summary.
categorystring | nullLaw category (e.g. labour_rights).
jurisdictionstring | nullIssuing jurisdiction.
citationstring | nullCitation / official URL.
evidence_supplier_should_providestring[]Evidence the supplier should provide.
adverse_media_concernsarray{ 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/facilities/legality"
  },
  "data": [
    {
      "type": "assessment",
      "id": "3fad3b99-0000-0000-0000-000000000000",
      "attributes": {
        "location_id": "81895eee-e2bd-4b65-b75d-3c92110b5552",
        "location_type": "facility",
        "commodity": "palm",
        "country_code": "BR",
        "name": "Example Facility",
        "legality_risk_level": "low",
        "legality_risk_score": 0.12,
        "legality_raised_flag_count": 0,
        "applicable_laws": []
      },
      "links": {
        "self": "/assessments/facilities/81895eee-e2bd-4b65-b75d-3c92110b5552/legality"
      }
    }
  ]
}

Required scope: assessments:read