Facility by ID

Retrieve a single facility by its ID.

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

Request

Method & Path

GET /locations/facilities/:id

Path parameters

  • id (uuid, required) โ€” Accepts the facility's id, its UUID, or the location_id surfaced on ingestion results.

Query parameters

  • include_geometries (true / false, default false) โ€” when true, the geo attribute is included in the JSON response. Omitted by default. 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 is included in the JSON response. Omitted by default. A GeoJSON Accept format (application/geo+json) always returns geometry regardless of this flag. See Query Parameters โ†’ Geometry.

Response

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

Pass ?include=assessment to attach this facility'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