Shed Location Deforestation

Get the latest deforestation metrics for a specific location.

Returns one metric per commodity. For a facility with both palm and cocoa sheds, this returns two metric resources. Use filter[commodity] to narrow to a single commodity.

This is a convenience endpoint equivalent to:

GET /metrics/deforestation?filter[location_id]=:id&filter[process_id]=latest

Request

Method & Path

GET /metrics/sheds/:id/deforestation

Path parameters

  • id (uuid, required) โ€” The location ID.

Response

  • 200 โ€” List of latest deforestation metrics (one per commodity).
  • 404 โ€” Location not found or not accessible.

Also available for other metric types:

  • GET /metrics/sheds/:id/biodiversity
  • GET /metrics/sheds/:id/emissions
  • GET /metrics/sheds/:id/water_stress

The data shape matches the top-level metric list endpoint. See List Deforestation for the full attribute table.

Geometry

Geometry is opt-in โ€” pass ?include_geometries=true to include the geo attribute (the location's geometry) on JSON / NDJSON responses (GeoJSON formats always include it). See Query Parameters โ†’ Geometry.

Required scope: metrics:read