GET/api/partner/v1/gps/positions

Live positions

Where every tracked car is right now.

One row per tracked car, carrying its newest fix — the live map feed. total counts your active devices while items carries only those that have actually reported, so a device that has never sent a fix simply has no row. A fix older than 15 minutes comes back with online: false and its own ageSeconds.

Authorization

X-Api-Key header

Send your partner key on every request. An owner key acts for its one owner; an integration token also needs the owner's id in the X-Owner-Id header.

Query parameters

carIdstringquery

Restrict to one of your cars (our id or your external car id). Omit for the whole fleet over the period — neither form requires a booking or a driver.

pageintegerquery

1-based page number.

Default: 1

pageSizeintegerquery

Rows per page. Capped at 1000.

Default: 100

Response

200 · application/json

successbooleanrequired

dataobject

The shape of data on every list endpoint. items is added by each list's own schema.

pageintegerrequired

1-based page number you asked for.

pageSizeintegerrequired

totalintegerrequired

Rows in the whole filtered set

hasMorebooleanrequired

Another page is waiting — request page+1.

itemsGpsPosition[]

errorstringnullable

Status codes

200One page of live positions.

401Missing, unknown or revoked API key.

{ "success": true, "data": { "page": 1, "pageSize": 1, "total": 1, "hasMore": true, "items": [ { "carId": "CAR-1042", "externalCarId": "CAR-1042", "plateNumber": "K72LMX", "plateState": "NJ", "trackerId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d", "imei": "350424060123456", "source": null, "sourceName": "Aegis", "tsUtc": "2026-08-16T14:05:12Z", "lat": 40.7357, "lon": -74.1724, "speedKmh": 96, "speedMph": 59.7, "headingDeg": 214, "ignition": true, "satellites": 11, "ageSeconds": 47, "online": true } ] }, "error": null }