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=deforestation attaches the roll-up under relationships.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), or not_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)

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.

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