Skip to main content
POST
Get Position History

Overview

Returns a minimal position list per point in the UTC window [from, to].
⚠️ Note: GetPositionDataAsync does not call AuthenticateByVehicle in the current implementation—authorization relies on upstream layers only. Confirm with Telemax whether this is intentional for your deployment.
A V2 version of this endpoint is available: Position history. New integrations should prefer V2.

Endpoint

POST /api/GetPositionData

Query parameters

integer
required
Legacy vehicle id.
string (datetime)
required
Start (stored as UTC).
string (datetime)
required
End (stored as UTC).

Response

200 OKMinPositionDto[] with fields UtcTime, UserTime, Lat, Lng, Speed, Ignition, Odometer, Voltage (JSON name "Voltage"), DeviceId, DeviceName, FuelLevel, DTC.

Error responses

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from POST /api/authentication/token/user or POST /api/authentication/token/api-key.

Lifetime: ~24 hours (86,399 seconds). Cache the token and reuse it. Re-authenticate 5 minutes before expiry.

Scoping:

  • User tokens are scoped to a single company.
  • API key tokens may restrict access to a vehicle allowlist and/or action set (see token claims).

No refresh endpoint — re-authenticate with your credentials when the token expires.

Headers

Content-Type
string
Authorization
string
required

Bearer your_token

Query Parameters

id
integer
required

Vehicle ID

from
string
required
to
string
required

Response

Successful response