Resolve IMEI
Telemetry & replay
Lookup by IMEI
Resolve a device IMEI to legacy vehicle id and name.
GET
Resolve IMEI
Overview
Resolves a device IMEI to legacy vehicle id and name for vehicles the caller may access.A V2 version of this endpoint is available: Device ID from IMEI. New integrations should prefer V2.
Endpoint
GET /api/GetDeviceId/{imei}
Path parameters
string
required
Tracker IMEI (digits as stored in Telemax).
Response
200 OK —ImeiSearchResultDto
Error responses
Example response
cURL
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.
Headers
Bearer your_token
Path Parameters
Tracker IMEI