Application Zones Endpoint
Application zone metadata (name, boundary, crop, rate, and pump station).
Endpoints: GET /api/v1/application_zones, GET /api/v1/application_zones/{zone_id}
Returns application zone metadata: name, boundary, crop, application rate, and linked pump station. Use these endpoints to fill the Assets list or a zone screen. For time-series data (ET, irrigation, vegetation indices) by zone, see the Application Zones Data Endpoint. Creating a zone is covered in the Asset Workflow.
Authentication
Requires authentication via Bearer token (Authorization: Bearer <JWT>) or API key (x-api-key header). Results are scoped to organizations the identity can access.
List Application Zones
GET /api/v1/application_zones
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
organization_id | integer | No | Filter by organization. Omit to use all organizations the user can access. This is the filter the Assets screen uses. |
include_archived | boolean | No | Include archived zones. Default: false. |
skip | integer | No | Records to skip for pagination. Default: 0. |
limit | integer | No | Max records to return (1–10,000). Default: 200. |
Response
{
"application_zones": [
{
"id": "uuid",
"organization_id": 1,
"name": "Block 4",
"pump_station_id": "uuid",
"pump_station_name": "North station",
"crop_id": 3,
"variety_id": 12,
"geometries": { "type": "MultiPolygon", "coordinates": [...] },
"irrigation_type": "drip",
"application_rate_mm_per_hr": 1.23,
"application_rate": 1.23,
"status": "active",
"created_at": "ISO 8601",
"updated_at": "ISO 8601"
}
],
"total_count": 42
}Get Application Zone by ID
GET /api/v1/application_zones/{zone_id}
Returns a single application zone by UUID. Returns 404 if the zone is not found or outside the user's organization scope.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
zone_id | UUID | Application zone identifier. |
Response
Same structure as a single item in the list application_zones array above.