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	Numeric John Deere organization ID (e.g. "265077")
fieldId	string	Optional	John Deere field ID (UUID from listResources externalId) to filter to a single field — optional
operationType	`planting` \| `harvest` \| `application` \| `tillage` \| `all`	Optional	Filter by operation type
dateRange	object	Optional	Date range filter
limit	integer	Optional	Max results (default: 50)
offset	integer	Optional	Skip N results

See Error Handling for recovery patterns and retry strategies.