Skip to content

Get subscription location

Request

This endpoint retrieves the location information of a specific subscription associated with an eSIM, identified by its ICCID. It provides information about the last operator the SIM was connected to, including country, operator name, and technical details.

Important: This endpoint only returns data if the SIM has been active in the last 7 days. If the SIM has not been active during this period, the last_operator field will be null.

Security
ApiKeyAuth
Path
iccidstringrequired

The ICCID of the subscription

Example:8937204017179541233
GET
/v3/subscriptions/{iccid}/location
curl -i -X GET \
  'https://api.tellisim.com/v3/subscriptions/8937204017179541233/location?key=YOUR_API_KEY_HERE'

Responses

Successful response containing location information

Bodyapplication/json
errorbooleanrequired

Indicates if there was an error with the request

Example:false
last_operatorobject or nullrequired

Information about the last operator the SIM was connected to. Returns null if the SIM has not been active in the last 7 days.

Response
{
  "error": false,
  "last_operator": {
    "country": "Jordan",
    "country_alpha_2": "jo",
    "operator": "ZAIN Jordan",
    "event_time": "2022-11-21T23:08:51.333+01:00",
    "rat": "4G - LTE",
    "imei": "356703224849612"
  }
}