---
title: "Perform detailed tracker health check"
method: GET
path: "/tracker_health/check"
tags: ["Tracking|Tracker health"]
---

# Perform detailed tracker health check

`GET /tracker_health/check`

Retrieves comprehensive diagnostic information for a vehicle's tracker, including its current status and any detected issues.
Useful for automated monitoring, maintenance scheduling, and installation validation.

Performs an anomaly check on tracker data to identify irregular or inconsistent tracking behavior.
This endpoint analyzes recent tracker records to detect the following anomaly types:


Jumping Trackpoints – Indicates sudden, unrealistic jumps in location.

High Voltage Without Ignition – Detects elevated voltage levels when the ignition signal is off.

Voltage Drop / Possible Tampering – Detects sudden drops or interruptions in voltage that may indicate manipulation or wiring issues.

Tracker Not Sending Data – Missing or delayed transmissions for an extended period.

No Beacon Reception – The tracker is active but does not receive any beacons for an extended time.

Poor GPS Reception – Tracker shows consistently weak or unreliable GPS signal quality.

Poor GSM Reception – Weak or unstable mobile network signal strength.

Incorrect Permanent Power Wiring – No voltage is detected when the ignition is off, indicating the permanent power source may be incorrectly connected.

Time-Tracking Sensor Check – Verifies that all time-tracking sensors transmit data.

Hidden on Map View – The tracker is not visible on the map because the “show on map” option is disabled.

Excessive Data Transmission – The vehicle sends unusually high amounts of tracking data within a day.

Flickering Ignition Signal – Rapid, inconsistent changes in the ignition state indicating unstable or faulty wiring.

Missing Tachograph Data – Tachograph data is not being transmitted.

Missing Live / FMS Data – FMS data is not being transmitted.

## Query parameters

- `vehicleId` integer
- `days` integer

## Response `200`

Success Response:

- StandardTrackerHealthCheckResponse
  - `status` string — Overall operational status of the tracker, derived from recent performance and signal data. Possible values: - `OK` → The tracker is fully operational, no issues detected. - `WARNING` → Minor irregularities detected that may require attention. - `FAILURE` → Major malfunction detected or tracker is not reporting correctly. This field is intended for automated monitoring systems to quickly classify tracker health.
  - `issues` object[] — A list of all identified issues affecting the tracker’s performance or connectivity. Each issue entry includes a descriptive message, severity level, and suggested corrective action. If no problems are found, this array may be empty.
    - `message` string — Human-readable description of the detected issue, based on diagnostic rules. Typically explains the symptom.
    - `severity` integer — Severity level of the issue.
    - `recommendation` string — Recommended corrective action or troubleshooting step to resolve the issue. Provides practical guidance for technicians or automated maintenance systems.
    - `lastOccurrence` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx

---

[API](https://skmtc.net/geocapture/apis/geocapture-api.md) · [All operations](https://skmtc.net/geocapture/apis/geocapture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocapture/geocapture-api/versions/869b05603541/schema)