Fleet last-time-online (V2)
Companies & fleet
Fleet last-time-online
Last-seen timestamps for all vehicles in the company.
GET
Fleet last-time-online (V2)
Overview
Returns the last time each vehicle in the company was seen online, along with how many seconds ago that was.The V1 version of this endpoint is Fleet last online. V2 is paginated.
Rate limit: 20 requests per 60 seconds per token.
Endpoint
GET /api/v2/companies/{id}/vehicles/last-time-online
Path parameters
Company ID.
Query parameters
Page number (1-based).
Records per page.
Response
200 OK —PagedListResult<DeviceLastTimeOnlineDto>
| Field | Type | Description |
|---|---|---|
| vehicleId | integer | Legacy vehicle ID |
| imei | string | null | Device IMEI |
| lastTimeOnlineUtc | datetime | null | Last seen timestamp (UTC, no fractional seconds) |
| secondsAgo | number | null | Seconds elapsed since last contact |
Error responses
| Status | Meaning |
|---|---|
| 401 | Token not scoped to this company |
| 403 | Company not in caller’s accessible hierarchy |
| 404 | Company not found |
Authorizations
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
Response
Successful response