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.
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.
Parameters
Request
Response
Get operation filteredGeoParquet
GET/operations/{id}/filteredGeoparquet
Returns a URL to the filtered GeoParquet file for the operation.
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.
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
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
Get files from an operation
GET/operations/{id}/files
Returns the machine files that were aggregated to produce the field operation.

