Get SIM connectivity info by GPS IMEI
Get real-time or cached connectivity information for a GPS device by its IMEI.
This endpoint:
- Looks up the GPS device by IMEI
- Finds the associated SIM phone number
- Gets the Emnify endpoint_id from the ChipCatalog
- Fetches fresh connectivity data from Emnify API (network type, operator, last connection)
- Falls back to cached data from database if API call fails
Response Status Values:
live: Fresh data from Emnify APIcached: Data from local database (API call failed or unavailable)no_sim: GPS device has no associated SIMno_endpoint: SIM found but no Emnify endpoint_iderror: Error fetching from API, returned cached data
Notes:
- Only works for Emnify SIMs (phone numbers starting with “42”)
- Data includes network type (2G/3G/LTE/5G), operator name, and last connection timestamp
- Cached data may be stale; check the
statusfield
Authorizations
Bearer token authentication
Path Parameters
GPS device IMEI (15 digits)
"866425031234567"
Response
Connectivity data retrieved successfully
GPS device IMEI
"866425031234567"
SIM phone number
"4201234567"
Emnify endpoint ID
123456
Network type (e.g., 2G, 3G, LTE, 5G)
"LTE"
Mobile operator name
"Movistar Chile"
Last connection timestamp (ISO 8601)
"2026-02-11T12:34:56.000Z"
Device connection status from Emnify: ONLINE, OFFLINE, ATTACHED
ONLINE, OFFLINE, ATTACHED "ONLINE"
Country name where the device is currently connected
"Chile"
Data source status: live (fresh from API), cached (from DB), no_sim, no_endpoint, error
live, cached, no_sim, no_endpoint, error "live"
Active PDP context (session) details. Null when device is offline.