Get Fleet Heartbeat
Companies & fleet
Get fleet last online
Last heartbeat per vehicle in a company.
POST
Get Fleet Heartbeat
Overview
Returns last heartbeat per vehicle in a company (legacyVehicleId in each row).
A V2 version of this endpoint is available: Fleet last-time-online. New integrations should prefer V2.
Endpoint
POST /api/GetAllLastTimeOnline/{companyId}
Path parameters
Company id.
Response
200 OK —DeviceLastTimeOnlineDto[] with VehicleId, Imei, LastTimeUTC, secondsAgo.
Error responses
| Status | Meaning |
|---|---|
| 401 | { "error": "Company {companyId} not found" } when not in tree |
Authorizations
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.
Path Parameters
Response
Successful response