Device Unlock Status
Check the carrier unlock status of a device by IMEI or by phone number. Works for any IMEI, including devices on other carriers that have never been provisioned on the Telegent network.
Two ways to look up a device:
- By
IMEI— the general-purpose lookup. Works for any device on any carrier, whether or not it exists in your account.PhoneNumberis returned empty. - By
PhoneNumber— only works for numbers assigned to your own account. The device’sIMEIis resolved automatically and returned alongside the lock status.
PhoneNumber is optional; if it is blank, IMEI is required. The response shape is the same either way.
Reading the response: This endpoint returns HTTP 200 even when the lookup fails. Always check the Status field — Success means UnlockStatus is populated, FAILED means UnlockStatus is null and StatusMessage carries the upstream error (for example GENS-0020 Invalid IMEI or GENS-0013 Invalid MSISDN).
Next steps:
- Retrieve device model, manufacturer and TAC —
POST /v1.0/numbers/device-details - Check the number’s service status —
POST /v1.0/numbers/status
Body
Phone number of a device already on your account (E.164 format). Optional — when provided, the IMEI is resolved automatically. If left blank, IMEI is required.
"+12017540711"
15-digit IMEI of the device to check. Required when PhoneNumber is blank. Accepts any IMEI, including devices not provisioned on the Telegent network.
"357100775549659"
Response
Device Unlock Status Retrieved
The response is of type object.