deere_get_field_overview

Get comprehensive field data in a single call. Returns field details with optional boundary geometry, recent operations, flags, and guidance lines.

Parameters

Parameter	Type	Required	Default	Description
`orgId`	string	Yes	—	Organization ID
`fieldId`	string	Yes	—	Field ID
`include`	string[]	No	`["details", "boundary"]`	Sections to include: `details`, `boundary`, `operations`, `flags`, `guidance`
`operationsDateRange`	object	No	—	`{ startDate, endDate }` in YYYY-MM-DD format
`operationsLimit`	number	No	10	Max operations to return (1-50)

Usage

Basic Field Details

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

Full Field Overview with Operations

{
  "orgId": "123",
  "fieldId": "abc",
  "include": ["details", "boundary", "operations", "flags"],
  "operationsDateRange": {
    "startDate": "2025-01-01"
  }
}

Response

{
  "error": false,
  "data": {
    "field": {
      "id": "field-uuid",
      "externalId": "abc",
      "provider": "john_deere",
      "organizationId": "123",
      "name": "North 40",
      "acres": 40.5,
      "activeCrop": "corn"
    },
    "canonicalFieldId": "uuid-stable-across-providers",
    "boundary": {
      "type": "Polygon",
      "coordinates": [[[...], [...], ...]]
    },
    "operations": [
      {
        "id": "op-uuid",
        "fieldId": "abc",
        "date": "2025-04-15",
        "operationType": "planting",
        "crop": "corn",
        "details": {
          "variety": "DKC62-08",
          "seedingRate": 34000
        }
      }
    ],
    "flags": [
      {
        "id": "flag-uuid",
        "fieldId": "abc",
        "name": "Tile Inlet",
        "coordinates": { "lat": 42.0, "lon": -93.6 },
        "flagType": "drainage"
      }
    ]
  },
  "dataQuality": "COMPLETE"
}

The canonicalFieldId is a stable UUID assigned when the field is synced — use it to reference fields consistently across providers.

Partial Success

If some sections fail to load (e.g., boundary times out but details succeed), the tool returns dataQuality: "PARTIAL" with a missingData array explaining what failed:

{
  "dataQuality": "PARTIAL",
  "missingData": [
    {
      "field": "boundary",
      "impact": "degraded",
      "message": "Boundary request timed out"
    }
  ]
}

Errors

Code	Cause
`FIELD_NOT_FOUND`	Field doesn't exist in this organization
`TOKEN_EXPIRED`	John Deere token expired
`PROVIDER_TIMEOUT`	John Deere API timed out

Parameter	Type	Required	Description
orgId	string	Required	Organization ID
fieldId	string	Required	Field ID
include	array	Optional
operationsDateRange	object	Optional
operationsLimit	number	Optional

Try it

deere_get_field_overview

orgId*

fieldId*

include

operationsDateRange

operationsLimit

Parameters

Parameter	Type	Required	Default	Description
`orgId`	string	Yes	—	Organization ID
`fieldId`	string	Yes	—	Field ID
`include`	string[]	No	`["details", "boundary"]`	Sections to include: `details`, `boundary`, `operations`, `flags`, `guidance`
`operationsDateRange`	object	No	—	`{ startDate, endDate }` in YYYY-MM-DD format
`operationsLimit`	number	No	10	Max operations to return (1-50)

Response

{
  "error": false,
  "data": {
    "field": {
      "id": "field-uuid",
      "externalId": "abc",
      "provider": "john_deere",
      "organizationId": "123",
      "name": "North 40",
      "acres": 40.5,
      "activeCrop": "corn"
    },
    "canonicalFieldId": "uuid-stable-across-providers",
    "boundary": {
      "type": "Polygon",
      "coordinates": [[[...], [...], ...]]
    },
    "operations": [
      {
        "id": "op-uuid",
        "fieldId": "abc",
        "date": "2025-04-15",
        "operationType": "planting",
        "crop": "corn",
        "details": {
          "variety": "DKC62-08",
          "seedingRate": 34000
        }
      }
    ],
    "flags": [
      {
        "id": "flag-uuid",
        "fieldId": "abc",
        "name": "Tile Inlet",
        "coordinates": { "lat": 42.0, "lon": -93.6 },
        "flagType": "drainage"
      }
    ]
  },
  "dataQuality": "COMPLETE"
}

The canonicalFieldId is a stable UUID assigned when the field is synced — use it to reference fields consistently across providers.

Partial Success

If some sections fail to load (e.g., boundary times out but details succeed), the tool returns dataQuality: "PARTIAL" with a missingData array explaining what failed:

{
  "dataQuality": "PARTIAL",
  "missingData": [
    {
      "field": "boundary",
      "impact": "degraded",
      "message": "Boundary request timed out"
    }
  ]
}

Errors

Code	Cause
`FIELD_NOT_FOUND`	Field doesn't exist in this organization
`TOKEN_EXPIRED`	John Deere token expired
`PROVIDER_TIMEOUT`	John Deere API timed out

Parameter	Type	Required	Description
orgId	string	Required	Organization ID
fieldId	string	Required	Field ID
include	array	Optional
operationsDateRange	object	Optional
operationsLimit	number	Optional

Try it

deere_get_field_overview

orgId*

fieldId*

include

operationsDateRange

operationsLimit

Search Documentation

deere_get_field_overview

Parameters

Usage

Basic Field Details

Full Field Overview with Operations

Response

Partial Success

Errors

Try it

Search Documentation

deere_get_field_overview

Parameters

Usage

Basic Field Details

Full Field Overview with Operations

Response

Partial Success

Errors

Try it