---
title: "Fetch counter list."
method: GET
path: "/tracker_counter/fetch"
tags: ["Tracking|Counter"]
---

# Fetch counter list.

`GET /tracker_counter/fetch`

This method allows you to get counter information from the trackers, such as distance driven or operating hours.
Please be aware that the distance travelled as calculated by the GPS signal may differ from the actual mileage
displayed in the vehicle. Be aware that the counter type is not equal to the unit of the `counterValue`. The
counter value's unit is provided in the `unitType`. Tracker counters can function as both sensors within the GPS
tracker and as calculated values from geoCapture for a specific counter.

## Query parameters

- `trackers[byIds][]` integer[]
- `trackers[byLicenseNumbers][]` string[]
- `trackers[byIdentifiers][]` string[]
- `trackers[byIdentificationNumbers][]` string[]
- `trackers[byImportKeys][]` string[]
- `trackers[importSource]` string
- `trackers[byName]` string
- `trackers[byDriver]` string
- `date` string

## Response `200`

Success Response:

- StandardTrackerCounterFetchResponse
  - `trackers` object[] — The vehicles.
    - `id` integer — The internal vehicle ID.
    - `identifier` string — The customer-specific ID. (max. 64 characters)
    - `inventoryNumber` string — The inventory number. (max. 128 characters)
    - `licenseNumber` string — The vehicle license plate. (max. 255 characters)
    - `identificationNumber` string — The vehicle identification number. (max. 24 characters)
    - `importSource` string — External data source from which this vehicle originates. (max. 64 characters)
    - `importKey` string — External ID from the respective data source. (max. 64 characters)
    - `name` string — The vehicle name. (max. 255 characters)
    - `sensors` object[] — Relevant sensors.
      - `id` integer — The internal sensor ID.
      - `name` string — The sensor name.
      - `type` string — The sensor type. | Value | Description | | ------------------------ | ------------------------------------------- | | ALTITUDE | Height | | SPEED | Speed | | DIRECTION | Direction | | GPS_SIGNAL_QUALITY | GPS signal strength (Number of satellites) | | GSM_SIGNAL_QUALITY | GSM signal strength | | POWER_SUPPLY_VOLTAGE | Voltage | | EMPLOYEE | Employee | | PIECE | Piece | | SECOND | Second | | MINUTE | Minute | | DEGREE | Degree | | MILLIVOLT | Millivolt | | METER | Meter | | METER_PER_SEC2 | Meter/s² | | KILOMETER | Kilometer | | KILOMETER_PER_HOUR | Kilometer/h | | LITER | Liter | | LITER_PER_100KM | Liter/100 km | | VOLT | Volt | | AMPERE | Ampere | | MILLIAMPERE | Milliampere | | PERCENT | Percent | | DEGREE_CELSIUS | Degrees Celsius (°C) | | BOOLEAN | On/Off | | ID | ID | | NUMBER | Number | | METER2 | Meter² | | HECTARE | Hectar |
  - `counters` object[] — The counters.
    - `id` integer — The internal counter ID.
    - `trackerId` integer — The internal vehicle ID.
    - `sensorId` integer — The internal sensor ID.
    - `name` string — The counter name.
    - `type` string — The counter type. | Value | Description | |------------------|--------------------------| | KILOMETER | Kilometers | | OPERATING_HOURS | operating hours | | SENSOR | Sensor |
    - `mode` string — The counter mode. | Value | Description | |------------------|---------------------------| | DISTANCE | Distance | | DURATION | Duration | | OCCURRENCE | Occurances | | AREA | Area | | VALUE | value |
    - `unitType` string — The counter unit.
    - `counterValue` number — The counter value.
    - `counterDate` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd

---

[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)