Browse

Core confidence assessment โ€” the confidence score/level plus the geometric and facility-plausibility flags.

Returns the latest core assessment per supply shed, 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.

Request

Method & Path

GET /assessments/sheds/core

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[confidence_level]string (eq, in)Core confidence level (e.g. low, medium, high).
filter[confidence_score_min]numeric (eq)Minimum confidence score (inclusive).
filter[confidence_score_max]numeric (eq)Maximum confidence score (inclusive).
filter[since]date (eq)Only assessments with sco2_run_at on or after this date.

Sorting

?sort= keys (leading - = descending): since (default -since), confidence_score, created_at.

Response

  • 200 โ€” Paginated list of core 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 Core-specific attributes:

FieldTypeDescription
confidence_scorenumber | nullConfidence score (0โ€“1).
confidence_levelstring | nullConfidence level (high/medium/low).
confidence_commentstring | nullRationale for the core confidence assessment.
producer_confirmation_scorenumber | nullProducer confirmation score (0โ€“1).
producer_confirmedboolean | nullWhether the producer was confirmed.
producer_confirmation_commentstring | nullRationale for the producer confirmation outcome.
road_accessboolean | nullRoad access present.
water_accessboolean | nullWater access present.
port_proximityboolean | nullNear a port.
poi_presenceboolean | nullPoint-of-interest presence.
high_densityboolean | nullHigh building density.
commodity_presencenumber | nullTri-state gradient (0 | 0.5 | 1).
building_presencenumber | nullTri-state gradient (0 | 0.5 | 1).
imagery_confidence_scorenumber | nullConfidence in the facility imagery match (0โ€“1).
imagery_confidence_commentstring | nullOne-sentence rationale for the imagery-confidence score.
supply_chain_rolestring | nullInferred supplier role (first_mile | downstream | unknown).
facility_is_polygonboolean | nullTrue when the facility input arrived as a polygon geometry.

Presence / access flags (road_access, water_access, port_proximity, poi_presence, high_density) are JSON booleans. The tri-state gradients (commodity_presence, building_presence) stay numeric (0 | 0.5 | 1) on purpose.

Sample response

{
  "meta": {
    "page": 1,
    "page_size": 1,
    "total": 1,
    "has_next": false
  },
  "links": {
    "self": "/assessments/sheds/core"
  },
  "data": [
    {
      "type": "assessment",
      "id": "3fad3b99-0000-0000-0000-000000000000",
      "attributes": {
        "location_id": "81895eee-e2bd-4b65-b75d-3c92110b5552",
        "location_type": "shed",
        "commodity": "palm",
        "country_code": "BR",
        "name": "Example Supply Shed",
        "confidence_score": 0.91,
        "confidence_level": "high",
        "supply_chain_role": "first_mile"
      },
      "links": {
        "self": "/assessments/sheds/81895eee-e2bd-4b65-b75d-3c92110b5552/core"
      }
    }
  ]
}

Required scope: assessments:read