Skip to main content
Leaf connects to irrigation providers (Lindsay FieldNET and Valley) to pull equipment data, as-applied irrigation activities, and field-level irrigation summaries into a single API.

​
Data types

​
Irrigation equipment

Equipment records represent physical irrigation infrastructure: pivots, lateral moves, and sensors. Each equipment record belongs to a Leaf user and includes the equipment’s location and type.

​
As-applied irrigation

As-applied irrigation data represents the actual irrigation events reported by the equipment. Each record is summarized by day and split by depth, showing the amount of water applied across a multipolygon geometry.

​
Irrigated field

Irrigated field records show how an irrigation event intersects with a specific field boundary. The irrigation geometries are clipped to the field boundary, so you see only the portion of irrigation that falls within the field. Different water depths across zones or angles are represented as separate multipolygon geometries within the record.

​
Endpoints

Base URL: https://api.withleaf.io/services/irrigation/api
ActionMethodPath
List irrigation equipmentGET/users/{leafUserId}/irrigation-equipment
Get irrigation equipmentGET/users/{leafUserId}/irrigation-equipment/{id}
List as-applied irrigationGET/users/{leafUserId}/irrigation/applied-irrigation
Get an irrigation activityGET/users/{leafUserId}/irrigation/applied-irrigation/{id}
List irrigated fieldsGET/users/{leafUserId}/irrigation/fields
Get an irrigated fieldGET/users/{leafUserId}/irrigation/fields/{fieldId}
Get an irrigated field activityGET/users/{leafUserId}/irrigation/fields/{fieldId}/irrigated/{id}

​
Configuration

The irrigationProcessingRange configuration controls how far back Leaf fetches irrigation data from providers. Default is 12 months. See Configuration for details.

​
Alerts

Two irrigation-specific events are available:
  • newIrrigationActivity fires when new as-applied data arrives from a provider.
  • newFieldIrrigationActivity fires when irrigation data is matched to a field boundary.
See Alert Events for payload schemas.

​
What to do next

Last modified on March 24, 2026