> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withleaf.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Irrigation Overview

> Pull irrigation data from Lindsay and Valley through the Leaf API: as-applied activities, irrigated field summaries, and equipment like pivots and sensors.

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`

| Action                          | Method | Path                                                             |
| ------------------------------- | ------ | ---------------------------------------------------------------- |
| List irrigation equipment       | GET    | `/users/{leafUserId}/irrigation-equipment`                       |
| Get irrigation equipment        | GET    | `/users/{leafUserId}/irrigation-equipment/{id}`                  |
| List as-applied irrigation      | GET    | `/users/{leafUserId}/irrigation/applied-irrigation`              |
| Get an irrigation activity      | GET    | `/users/{leafUserId}/irrigation/applied-irrigation/{id}`         |
| List irrigated fields           | GET    | `/users/{leafUserId}/irrigation/fields`                          |
| Get an irrigated field          | GET    | `/users/{leafUserId}/irrigation/fields/{fieldId}`                |
| Get an irrigated field activity | GET    | `/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](/configuration/overview#irrigation) 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](/alerts/events#irrigation-events) for payload schemas.

## What to do next

* [Configuration](/configuration/overview) to adjust `irrigationProcessingRange`.
* [Irrigation API Reference](/api-reference/irrigation) for full endpoint details.