deere_get_equipment_status
Get equipment details with optional telemetry data. Returns machine info with current location, alerts, and engine hours.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
equipmentId | string | Yes | — | Equipment ID |
orgId | string | No | — | Organization ID (for context) |
include | string[] | No | ["details", "location"] | Sections: details, location, alerts, engineHours |
dateRange | object | No | — | { startDate, endDate } for historical telemetry |
Usage
Current Status
{
"equipmentId": "eq123"
}Full Telemetry with Alerts
{
"equipmentId": "eq123",
"include": ["details", "location", "alerts", "engineHours"]
}Response
{
"error": false,
"data": {
"equipment": {
"id": "eq-uuid",
"externalId": "eq123",
"provider": "john_deere",
"organizationId": "123",
"name": "8R 370",
"type": "tractor",
"make": "John Deere",
"model": "8R 370",
"year": 2023
},
"currentLocation": {
"id": "loc-uuid",
"equipmentId": "eq123",
"timestamp": "2025-03-15T14:30:00Z",
"coordinates": { "lat": 42.0, "lon": -93.6 },
"speed": 5.2,
"heading": 270
},
"alerts": [
{
"id": "alert-uuid",
"equipmentId": "eq123",
"alertType": "maintenance",
"severity": "medium",
"message": "Oil change due in 50 hours",
"timestamp": "2025-03-14T10:00:00Z",
"acknowledged": false
}
],
"engineHours": {
"id": "eh-uuid",
"equipmentId": "eq123",
"hours": 2450.5,
"timestamp": "2025-03-15T14:30:00Z"
}
},
"dataQuality": "COMPLETE"
}Alert Severity Levels
| Severity | Meaning |
|---|---|
low | Informational — no action needed |
medium | Attention needed soon |
high | Action required |
critical | Immediate attention required |
Errors
| Code | Cause |
|---|---|
EQUIPMENT_NOT_FOUND | Equipment doesn't exist |
TOKEN_EXPIRED | John Deere token expired |
PROVIDER_TIMEOUT | API timed out |
| Parameter | Type | Required | Description |
|---|---|---|---|
| equipmentId | string | Required | Equipment ID |
| orgId | string | Optional | |
| include | array | Optional | |
| dateRange | object | Optional |
Try it
deere_get_equipment_statusSign in to try this tool
Sign in