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_idsurfaced on ingestion results.
โถQuery parameters
- include_geometries (
true/false, defaultfalse) โ whentrue, thegeoattribute is included in the JSON response. Omitted by default. A GeoJSONAcceptformat (application/geo+json) always returns geometry regardless of this flag. See Query Parameters โ Geometry.
โถQuery parameters
- include_geometries (
true/false, defaultfalse) โ whentrue, thegeoattribute is included in the JSON response. Omitted by default. A GeoJSONAcceptformat (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.
โถRelated assessments (include=assessment)
include=assessment)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