Skip to main content
GET
/
api
/
v2
/
companies
/
{id}
/
vehicles
/
nearest
Nearest vehicles (V2)
curl --request GET \
  --url https://api.telemax.com.au/api/v2/companies/{id}/vehicles/nearest \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "vehicle": {
        "id": 1284686417,
        "utcTime": "2026-04-28T06:14:22",
        "userTime": "2026-04-28T16:14:22",
        "userTimeFormatted": "28/04/2026 04:14 PM",
        "lat": -33.8688,
        "lng": 151.2093,
        "speed": 0,
        "course": 142,
        "ignition": false,
        "odometer": 45321.2,
        "voltage": 12.8,
        "fatigue": "00:00:00",
        "engineHours": 1842.5,
        "satelliteCoverage": "Excellent",
        "satelliteCoverageRawValue": 12,
        "networkCoverage": "Excellent",
        "networkCoverageRawValue": 18,
        "deviceId": 88421,
        "ignitionTime": null,
        "deviceName": "Delivery Van 07",
        "imei": "353148090123456",
        "vin": "1HGBH41JXMN109186",
        "startMovingTime": null,
        "startMovingTimeUser": null,
        "lastMovementTime": "2026-04-28T05:50:00",
        "lastMovementTimeUser": "2026-04-28T15:50:00",
        "lastMovementTimeUserFormatted": "28/04/2026 03:50 PM",
        "drivingTime": null,
        "fuelLevel": null,
        "fuelVolume": null,
        "address": "42 George St, Sydney NSW 2000",
        "engineEnabled": true,
        "timeElapsed": 0.245,
        "startedTime": "2026-04-28T06:14:22",
        "endTime": "2026-04-28T06:14:22",
        "isOnline": false
      },
      "distance": 0,
      "realDistance": 0.028084
    }
  ],
  "totalResults": 2,
  "lastResultIndex": 2,
  "currentPage": 1,
  "numberOfPages": 1
}

​
Overview

Returns vehicles within the specified company sorted by distance from a given coordinate, optionally capped at a radius (metres) or a maximum result count.
The V1 version of this endpoint is Nearest vehicles. V2 is paginated.
Rate limit: 20 requests per 60 seconds per token.

​
Endpoint

GET /api/v2/companies/{id}/vehicles/nearest

​
Path parameters

​
id
integer
required
Company ID.

​
Query parameters

​
lat
number
Latitude of the reference point.
​
lng
number
Longitude of the reference point.
​
num
integer
Maximum number of vehicles to return (applied after radius filter). Defaults to 5000 if omitted.
​
radius
integer
Maximum distance in metres. Vehicles beyond this radius are excluded.
​
page
integer
default:"1"
Page number (1-based).
​
pageSize
integer
default:"50"
Records per page.

​
Response

200 OK — PagedListResult<NearestPointResultItemDto> Each item in the paginated items array:
FieldTypeDescription
vehicleobjectFull PositionDto for the vehicle (same shape as Last position)
distancenumberStraight-line distance in metres from the reference point
realDistancenumberRoad distance in metres (may equal distance if routing is unavailable)

​
Error responses

StatusMeaning
401Token not scoped to this company
403Company not in caller’s accessible hierarchy
404Company not found
curl "https://api.telemax.com.au/api/v2/companies/12/vehicles/nearest?lat=-33.8688&lng=151.2093&radius=5000" \
  -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

​
lat
number
​
lng
number
​
num
integer
​
radius
integer

Maximum distance in metres.

​
page
integer
default:1
​
pageSize
integer
default:50

Response

Successful response