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. The key is bound to exactly one owner account.

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 }