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 plot, 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/plots/biodiversity
โถ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). |
This slug additionally supports:
| Filter | Type | Description |
|---|---|---|
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
data[] attributesEvery assessment resource carries the shared identity / meta block (sourced
from the location + ingestion joins, not the assessment data):
| Field | Type | Description |
|---|---|---|
location_id | uuid | Type-specific location ID. |
location_type | facility | shed | plot | Underlying entity type. |
commodity | string | null | Commodity type. |
country_code | string | null | ISO 3166-1 alpha-2 country code. |
name | string | null | Normalised location name. |
geo | GeoJSON | null | Location geometry. |
sco2_run_at | ISO 8601 | null | Timestamp of the run that produced this assessment. |
asset_task_id | uuid | Ingestion task that linked this location. |
created_at | ISO 8601 | null | Creation timestamp. |
updated_at | ISO 8601 | null | Last update timestamp. |
Plus the Biodiversity-specific attributes:
| Field | Type | Description |
|---|---|---|
landscape_integrity_score | number | null | Composite biodiversity score (0โ1): the strongest of forest-landscape intactness, WDPA proximity and IFL proximity. Higher means more is at stake. null with landscape_integrity_check_failed false means not assessable. |
landscape_integrity_level | string | null | Concern band โ low, moderate, high or severe. |
landscape_natural_cover_fraction | number | null | Natural-habitat cover fraction of the assessed landscape (0โ1). |
landscape_patch_count | number | null | Natural-habitat patch count โ a fragmentation measure. |
landscape_rao_q | number | null | Mean Rao's Q structural diversity of the canopy. |
landscape_wdpa_km | number | null | Distance in km to the nearest WDPA protected area within the impact buffer; null when none falls inside it. |
landscape_ifl_km | number | null | Distance in km to the nearest Intact Forest Landscape within the impact buffer; null when none falls inside it. |
landscape_integrity_check_failed | boolean | null | true 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/plots/biodiversity"
},
"data": [
{
"type": "assessment",
"id": "3fad3b99-0000-0000-0000-000000000000",
"attributes": {
"location_id": "81895eee-e2bd-4b65-b75d-3c92110b5552",
"location_type": "plot",
"commodity": "palm",
"country_code": "BR",
"name": "Example Plot",
"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/plots/81895eee-e2bd-4b65-b75d-3c92110b5552/biodiversity"
}
}
]
}
Required scope:
assessments:read