Skip to main content
POST
/
api
/
GetPositionData
Get Position History
curl --request POST \
  --url https://api.telemax.com.au/api/GetPositionData \
  --header 'Authorization: Bearer <token>'
[
  {}
]

​
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

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

​
Response

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

​
Error responses

StatusMeaning
404Unknown legacy id

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