---
title: "Fetch GPS record list."
method: GET
path: "/track_point/fetch"
tags: ["Tracking|GPS record"]
---

# Fetch GPS record list.

`GET /track_point/fetch`

This method can be used to request the GPS records of a single tracker. You need to specify the tracker using the
filter options provided. Returned records are unsorted.

The maximum number of records returned is limited to 100,000 entries.
If there are more entries, the field **`complete`** is set to **`false`** in the response.
You can then use the **`lastTrackPointId`** field in the response to create a new query with the
`afterTrackPointId` parameter to return the subsequent entries.

With the **`afterTrackPointId`** parameter, it is also possible to create new records and requests.
All you need to do is pass the **`lastTrackPointId`** from the older request.

## Query parameters

- `tracker[byId]` integer
- `tracker[byLicenseNumber]` string
- `tracker[byIdentifier]` string
- `tracker[byIdentificationNumber]` string
- `tracker[byImportKey]` string
- `tracker[importSource]` string
- `afterTrackPointId` string

## Response `200`

Success Response:

- StandardTrackPointFetchResponse
  - `sensors` object[] — The vehicle 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 |
  - `trackPoints` object[] — The GPS records.
    - `id` string — The record ID.
    - `time` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `gpsSignalQuality` integer — The GPS signal quality.
    - `gsmSignalQuality` integer — The GSM signal quality.
    - `direction` number — The direction.
    - `speed` number — The speed.
    - `altitude` number — The height.
    - `powerSupplyVoltage` number — The power supply voltage.
    - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
    - `sensorValues` object[] — The sensor values.
      - `sensorId` integer — The sensor.
      - `value` number — The sensor value.
  - `lastTrackPointId` string — The ID of the last GPS record. With this ID, newer records can be queried later, when passed as the "afterTrackPointId" parameter.
  - `complete` boolean — Are the requested records complete? For a "false" value, further queries would have to be made with the "afterTrackPointId" parameter, to load all records. The value for the parameter is contained in the lastTrackPointId field.

---

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