Shed by ID

Retrieve a single shed by its ID.

Returns the full shed resource (links to its plots and metric endpoints). Geometry is opt-in โ€” see Query parameters below.

Request

Method & Path

GET /locations/sheds/:id

Path parameters

  • id (uuid, required) โ€” Shed ID. Equal to the location_id surfaced on ingestion results for sheds created via ingestion.

Query parameters

  • include_geometries (true / false, default false) โ€” when true, the geo attribute (the supply-shed polygon) is included in the JSON response. Omitted by default โ€” and shed polygons are large, so this matters most here. A GeoJSON Accept format (application/geo+json) always returns geometry regardless of this flag. See Query Parameters โ†’ Geometry.

Query parameters

  • include_geometries (true / false, default false) โ€” when true, the geo attribute (the supply-shed polygon) is included in the JSON response. Omitted by default โ€” and shed polygons are large, so this matters most here. A GeoJSON Accept format (application/geo+json) always returns geometry regardless of this flag. See Query Parameters โ†’ Geometry.

Response

  • 200 โ€” Shed resource.
  • 404 โ€” Shed not found or not accessible. See Error Codes.

Pass ?include=assessment to attach this supply shed's full assessment aggregate under relationships.assessment in one fetch. The base response stays gated on locations:read; the EUDR-scope legality / country-risk / EUDR-profile partitions additionally require assessments:read. See Assessments on Ingestion Responses and the Assessments API.

Required scope: locations:read