Browse

Landscape biodiversity assessment โ€” habitat intactness, fragmentation, canopy structural diversity, and proximity to protected areas and Intact Forest Landscapes.

Returns the latest biodiversity 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.

Request

Method & Path

GET /assessments/facilities/biodiversity

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[landscape_integrity_level]string (eq, in)Concern band (low, moderate, high, severe).
filter[since]date (eq)Only assessments with sco2_run_at on or after this date.

Sorting

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

Response

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

FieldTypeDescription
landscape_integrity_scorenumber | nullComposite biodiversity score (0โ€“1): the strongest of forest-landscape intactness, WDPA proximity and IFL proximity. Higher means more is at stake. For a sourcing-catchment row it is the commodity share of the area the commodity layer covers; landscape_commodity_coverage_fraction says how much of the catchment that is. null with landscape_integrity_check_failed false means not assessable: no usable catchment, or the layer does not cover it at all.
landscape_integrity_levelstring | nullConcern band โ€” low, moderate, high or severe. The band ignores coverage; read landscape_commodity_coverage_fraction before relying on it for a sourcing-catchment row.
landscape_natural_cover_fractionnumber | nullNatural-habitat cover fraction of the assessed landscape (0โ€“1).
landscape_commodity_coverage_fractionnumber | nullShare (0โ€“1) of the catchment the commodity layer has data for; the intrusion score rests on that share. 0 means the layer does not cover it.
landscape_patch_countnumber | nullNatural-habitat patch count โ€” a fragmentation measure.
landscape_rao_qnumber | nullMean Rao's Q structural diversity of the canopy.
landscape_wdpa_kmnumber | nullDistance in km to the nearest WDPA protected area within the impact buffer; null when none falls inside it.
landscape_ifl_kmnumber | nullDistance in km to the nearest Intact Forest Landscape within the impact buffer; null when none falls inside it.
landscape_integrity_check_failedboolean | nulltrue when this row's screen hit an error or ran out of time (the score or its forest context may be missing); retry it, it is not an absence of data.

Reading the score

landscape_integrity_score is a composite: it takes the strongest of the three underlying signals (forest-landscape intactness, proximity to a WDPA protected area, proximity to an Intact Forest Landscape) rather than averaging them, so a single strong signal is never diluted by two weak ones. A high score means the surrounding landscape has more biodiversity value at stake โ€” it is not itself a compliance verdict.

The two proximity fields are scoped to the location's impact buffer. A null means nothing of that kind lies within the buffer, which is materially different from a distance of zero.

Sample response

{
  "meta": {
    "page": 1,
    "page_size": 1,
    "total": 1,
    "has_next": false
  },
  "links": {
    "self": "/assessments/facilities/biodiversity"
  },
  "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",
        "landscape_integrity_score": 0.72,
        "landscape_integrity_level": "high",
        "landscape_natural_cover_fraction": 0.58,
        "landscape_patch_count": 34,
        "landscape_rao_q": 0.41,
        "landscape_wdpa_km": 3.2,
        "landscape_ifl_km": null
      },
      "links": {
        "self": "/assessments/facilities/81895eee-e2bd-4b65-b75d-3c92110b5552/biodiversity"
      }
    }
  ]
}

Required scope: assessments:read