Browse Locations
List and filter your locations. Choose the listing that matches what you want back:
| Endpoint | Returns |
|---|---|
GET /locations | All location types together (facilities, plots, and sheds in one mixed listing). |
GET /locations/facilities | Facilities only. |
GET /locations/plots | Plots only. |
GET /locations/sheds | Supply sheds only. |
GET /locations/commodity/:commodity | Locations for a single commodity (cattle, cocoa, coffee, palm, rubber, shrimp, soy, timber). |
GET /locations/groups/:prefix | Facilities/sheds grouped by the namespaced tags they carry (e.g. partno); plots roll up to their shed. |
Prefer a typed route (/facilities, /plots, /sheds) when you know the type you want โ they are faster than the mixed /locations listing, especially for tag filters. All routes support filtering by attributes (name, country, commodity, tags), sparse fieldsets, sorting, page-number and cursor pagination, and the JSON, GeoJSON, and streaming formats. See Query Parameters and Response Formats.
Required scope:
locations:read