deere_search_operations

Search field operations across an organization or for a specific field. Returns crop, dates, area, and type-specific details for planting, harvest, application, and tillage operations.

Parameters

Parameter	Type	Required	Default	Description
`orgId`	string	Yes	—	Organization ID
`fieldId`	string	No	—	Filter to a specific field
`operationType`	enum	No	`all`	`planting`, `harvest`, `application`, `tillage`, or `all`
`dateRange`	object	No	—	`{ startDate, endDate }` in YYYY-MM-DD format
`limit`	number	No	50	Results per page (1-100)
`offset`	number	No	0	Pagination offset

Usage

All Operations for a Field

{
  "orgId": "123",
  "fieldId": "abc"
}

Harvest Data for a Season

{
  "orgId": "123",
  "operationType": "harvest",
  "dateRange": {
    "startDate": "2025-09-01",
    "endDate": "2025-12-31"
  }
}

Response

{
  "error": false,
  "data": {
    "operations": [
      {
        "id": "op-uuid",
        "fieldId": "abc",
        "date": "2025-10-15",
        "operationType": "harvest",
        "crop": "corn",
        "area": 40.5,
        "yieldPerAcre": 185.3,
        "moisture": 15.2,
        "totalYield": 7504.65
      },
      {
        "id": "op-uuid-2",
        "fieldId": "abc",
        "date": "2025-04-20",
        "operationType": "planting",
        "crop": "corn",
        "area": 40.5,
        "variety": "DKC62-08",
        "seedingRate": 34000,
        "population": 34000
      }
    ],
    "pagination": {
      "total": 2,
      "offset": 0,
      "limit": 50,
      "hasMore": false
    }
  }
}

Operation-Specific Fields

Planting

Field	Description
`variety`	Seed variety
`seedingRate`	Seeds per acre
`population`	Plant population

Harvest

Field	Description
`yieldPerAcre`	Bushels per acre
`moisture`	Grain moisture percentage
`totalYield`	Total bushels

Application

Field	Description
`product`	Product name
`productType`	`fertilizer`, `herbicide`, `insecticide`, `fungicide`, `other`
`ratePerAcre`	Application rate
`rateUnit`	Rate unit (e.g., lbs, gal)

Tillage

Field	Description
`implement`	Tillage implement used
`depth`	Tillage depth

Notes

When searching across all fields in an organization (no fieldId), the tool queries up to 20 fields to avoid provider API limits. For large organizations, filter by fieldId for best results.

Errors

Code	Cause
`ORG_NOT_FOUND`	Organization doesn't exist
`NO_DATA_FOR_PERIOD`	No operations found in date range
`TOKEN_EXPIRED`	John Deere token expired
`PROVIDER_TIMEOUT`	Try a shorter date range

Parameter	Type	Required	Description
orgId	string	Required	Organization ID
fieldId	string	Optional
operationType	`planting` \| `harvest` \| `application` \| `tillage` \| `all`	Optional
dateRange	object	Optional
limit	number	Optional
offset	number	Optional

See Error Handling for recovery patterns and retry strategies.