Skip to content

Get a subscription

Request

This endpoint retrieves the details of a specific subscription associated with an eSIM, identified by its ICCID. It provides information such as the subscription ID, creation date, metadata, and SIM or Physical SIM details.

Security
ApiKeyAuth
Path
iccidstringrequired
GET
/v3/subscriptions/{iccid}
curl -i -X GET \
  'https://api.tellisim.com/v3/subscriptions/{iccid}?key=YOUR_API_KEY_HERE'

Responses

Successful response containing subscription details

Bodyapplication/json
errorbooleanrequired

Indicates whether there was an error processing the request

Example:false
dataobjectrequired

Contains the details of the subscription

Response
{
  "error": false,
  "data": {
    "subscription_id": "38838e12-4394-4e04-bb11-9250e835668e",
    "created_at": "2025-08-17T15:16:00.890Z",
    "metadata": "Subscription for USA",
    "customer_email": "customer@example.com",
    "tags": { … },
    "esim": { … }
  }
}