List Facilities
List facility-type locations.
Convenience route equivalent to GET /locations?filter[location_type]=eq:facility. Returns only locations where location_type is "facility". All other filters, pagination, sparse fields, and content negotiation work identically to the main list endpoint.
โถDeforestation compliance
Facilities carry a cached EUDR compliance roll-up over their catchment plots:
?include=deforestationattaches the roll-up underrelationships.deforestation(total_plots,compliant_plots,non_compliant_plots,unknown_plots,total_area_ha,compliant_area_ha).?filter[compliance]=eq:<status>narrows to a status, the first that applies:non_compliant(โฅ1 non-compliant plot),pending(no non-compliant plot, โฅ1 awaiting adjudication review),compliant(every non-excluded plot has a compliant result),excluded(every plot excluded from the filing), ornot_assessed(not a verdict: some plot has no deforestation result yet, or no cached roll-up).
GET /locations/facilities?filter[compliance]=eq:non_compliant&include=deforestation
See List Locations โ Includes for the block shape. (Sheds behave identically; plots are not yet supported.)
โถSuppliers (include=suppliers)
include=suppliers)Pass ?include=suppliers to list the registry suppliers linked to each
facility under attributes.suppliers, as [{ "id", "name" }] sorted by
name, or [] when none. Works in all four response formats. Needs a key
with parties:read; without it the attribute is omitted. See
List Locations โ Includes.
GET /locations/facilities?include=suppliers
โถSorting
Supports ?sort=id and โ unlike the untyped /locations route โ ?sort=created_at (-created_at for newest first). created_at orders by the per-org earliest-link timestamp. See List Locations โ Sorting and Query Parameters. Note created_at is not index-backed, so it scales with your org's facility count.
โถGeometry
Geometry is opt-in: pass ?include_geometries=true to include the geo
attribute on JSON / NDJSON responses (GeoJSON formats always include it). See
List Locations โ Geometry and
Query Parameters โ Geometry.
See List Locations for full documentation.
โถRelated assessments (include=assessment)
include=assessment)Pass ?include=assessment to attach each facility's full assessment aggregate
under relationships.assessment in one fetch. The base list 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