Skip to content

Get subscriber Geo-location

Request

This endpoint retrieves the geographic location data for a specific subscription identified by its ICCID. It provides the latitude, longitude, accuracy, and timestamp of the subscriber's last known location.

Important notes:

  • This feature has limited availability and is not supported for all labels
  • Location data may be unavailable if the eSIM has not yet been activated or has no usage history
  • Even when usage exists, location information may not be available if it was not captured by the system

The response includes:

  • Latitude and Longitude: Geographic coordinates of the last known position
  • Accuracy: The estimated median error in meters, representing the radius of a circle with 50% confidence level
  • Date and Time: Timestamp (UTC+0) indicating when the subscriber was last detected by the system
Security
ApiKeyAuth
Path
iccidstringrequired

The ICCID of the subscription

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

Responses

Successful response

Bodyapplication/json
One of:

Response when location data is available

errorbooleanrequired

Indicates if there was an error with the request

Example:false
dataobjectrequired

Geographic location data for the subscriber

Response
{
  "error": false,
  "data": {
    "latitude": 41.63565,
    "longitude": 41.60746,
    "accuracy": 2000,
    "date_time": "2026-04-17T19:43:25Z"
  }
}