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

Overview

Resolves a device IMEI to the vehicle ID 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 OKImeiSearchResultDto

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 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

imei
string
required

Response

Successful response