Skip to main content
GET
Device ID from IMEI (V2)

Overview

Resolves a device IMEI to the public vehicle ID (deviceId) and display name for vehicles the caller may access.
The V1 version of this endpoint is Lookup by IMEI.
Rate limit: 10 req/s · 60/min · 6,000/hr · 144,000/day

Endpoint

GET /v2/api/vehicles/{imei}/device-ids

Path parameters

string
required
Device IMEI (digits only, as stored in Telemax).

Response

200 OK — ImeiSearchResultDto

Example response

Error responses

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from POST /v2/api/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 by the key's company and its action set; see Token scoping.

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

Path Parameters

imei
string
required

Response

Successful response