Skip to main content
Use the operations endpoints to list and inspect Leaf’s merged field operations after machine files have been converted and allocated to field boundaries. This page covers operation retrieval, summaries, GeoJSON and GeoParquet outputs, images, units, and reprocessing. For conceptual background, see Field Operations.

Base URL

Endpoints


Get all field operations

GET /operations Returns a paginated list of field operations for the authenticated API owner.

Parameters

The default page size is 20 when page and size are not set.

Request

Response


Get a field operation

GET /operations/{id} Returns a single field operation by its UUID.

Parameters

Request

Response


Get operation summary

GET /operations/{id}/summary Returns the GeoJSON summary for a field operation. The summary contains aggregated statistics such as area, elevation, speed, and operation-specific properties (e.g., seed rate, applied rate, yield).

Parameters

Request


Get operation standardGeojson

GET /operations/{id}/standardGeojson Returns a URL to the standardGeojson file for the operation. This file contains all data points in Leaf’s standardized schema.

Parameters

Request

Response


Get operation standardGeoParquet

GET /operations/{id}/standardGeoparquet Returns a URL to the standard GeoParquet file for the operation.
You must enable the enableGeoparquetOutput configuration to use this endpoint.

Parameters

Request

Response


Get operation filteredGeojson

GET /operations/{id}/filteredGeojson Returns a URL to the filteredGeojson file for the operation. This file contains data points after Leaf applies statistical outlier removal.
You must enable the operationsFilteredGeojson configuration to use this endpoint.

Parameters

Request

Response


Get operation filteredGeoParquet

GET /operations/{id}/filteredGeoparquet Returns a URL to the filtered GeoParquet file for the operation.
You must enable both operationsFilteredGeojson and enableGeoparquetOutput configurations to use this endpoint.

Parameters

Request

Response


Get operation images

GET /operations/{id}/imagesV2 Returns improved PNG images based on the filteredGeojson. Each image includes a quantile-classified legend with 7 color-coded ranges and an extent for map plotting.

Parameters

Request

Response


Get operation geotiff images

GET /operations/{id}/geotiffImages Returns a list of GeoTIFF images generated from the operation’s properties based on the filteredGeojson.

Parameters

Request

Response


Get operation units

GET /operations/{id}/units Returns the property-to-unit mapping for the operation. Properties vary by operation type but use standardized keys across providers.

Parameters

Request


Get operation machines

GET /operations/{id}/machines Returns the UUIDs of machines used in the operation. Use the Assets endpoints to fetch full machine details.

Parameters

Request

Response


Get operation implements

GET /operations/{id}/implements Returns the UUIDs of implements used in the operation. Use the Assets endpoints to fetch full implement details.

Parameters

Request

Response


Get operation operators

GET /operations/{id}/operators Returns the UUIDs of operators who performed the operation. Use the Assets endpoints to fetch full operator details.

Parameters

Request

Response


Get operation sessions

GET /operations/{id}/sessions Returns compiled session data grouped by machine, with session time ranges, operator data, and covered area for each session in the operation.
Requires the enableOperationsSession configuration. Currently available for John Deere operations only.

Parameters

Request

Response


Crop operation by field

POST /operations/cropOperationByField Removes data points from the operation standardGeojson that fall outside the associated field boundary. Processing is asynchronous.

Request body

Request

Response

Use the leafFileId with the Alerts service to monitor processing status.

Reprocess field operations by field

POST /operations/reprocess Reprocesses field operations for one field and Leaf user. When overwrite is true, Leaf removes the existing operations for that field before regenerating them.

Request body

Request

Response


Reprocess an operation

POST /operations/{id}/reprocess Reprocesses an existing field operation starting from the merge step. The standardGeoJSON, filteredGeoJSON, summary, and images are regenerated.

Parameters

Request

Use the Alerts service to monitor the reprocessing status.

Get files from an operation

GET /operations/{id}/files Returns the machine files that were aggregated to produce the field operation.

Parameters

Request

Last modified on March 19, 2026