Skip to main content
GET
/
api
/
v2
/
safety-score
/
{id}
Safety score (V2)
curl --request GET \
  --url https://api.telemax.com.au/api/v2/safety-score/{id} \
  --header 'Authorization: Bearer <token>'
[
  {
    "startTime": "2026-04-28T03:10:00Z",
    "endTime": "2026-04-28T03:38:00Z",
    "riskLevel": "Low",
    "riskScore": 18,
    "duration": 1694,
    "distance": 23.6
  }
]

​
Overview

Returns trip-level safety scores for the specified vehicle. Supports explicit date ranges or preset time windows via intervalType.
The V1 version of this endpoint is Safety score.
Rate limit: 30 requests per 60 seconds per token.

​
Endpoint

GET /api/v2/safety-score/{id}

​
Path parameters

​
id
integer
required
Legacy vehicle ID.

​
Query parameters

​
start
string (datetime)
Range start. Optional when intervalType is supplied.
​
finish
string (datetime)
Range end. Optional when intervalType is supplied.
​
intervalType
integer
Preset window, used only when start and finish are omitted:
  • 1 — instant range (uses DateTime.UtcNow as start)
  • 2 — relative to end of today in the user’s timezone
  • 3 — three-day window
  • 4 — week window
⚠️ The window arithmetic uses a double-negative (-TimeSpan.FromDays(-N)) which adds days to finish for types 2–4. Validate results in staging before using preset windows in production.

​
Response

200 OK — array of trip safety score objects.
FieldTypeDescription
startTimedatetimeTrip start time
endTimedatetimeTrip end time
riskLevelstring"Low", "Medium", or "High"
riskScoreinteger (0–100)Numeric risk score; lower is safer
durationintegerTrip duration in seconds
distancenumberTrip distance in km

​
Error responses

StatusMeaning
401Token does not have access to this vehicle
403Token scope does not include safety score access
404Vehicle not found
400Invalid date range
curl "https://api.telemax.com.au/api/v2/safety-score/88421?start=2026-04-01T00:00:00Z&finish=2026-04-28T00:00:00Z" \
  -H "Authorization: Bearer <token>"

Authorizations

​
Authorization
string
header
required

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

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

Scoping: API key tokens are scoped to the company the key belongs to and may restrict access to a vehicle allowlist and/or action set (see token claims).

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

Path Parameters

​
id
integer
required

Query Parameters

​
start
string<date-time>
​
finish
string<date-time>
​
intervalType
integer

Preset window: 1=instant, 2=today, 3=3-day, 4=week.

Response

Successful response