Returns an eSIM, including its Subscriptions. The eSIM can be referenced by its ID or by its ICCID.
GET
/esims/{esimID}
curl \
--request GET 'https://zim.api.zimconnections.com/esims/esim_igFqGZhkRTHb0UNiRuAAA' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "X-App-Identifier: $API_KEY"
Response examples (200)
{
"id": "esim_kNsYsgLWJCesLTLsjoRGp",
"iccid": "8937103488884969991",
"matchingId": "2DAC33FBEB7D5A0C2F34659AF7A7842F5",
"smdpPlus": "smdpp.zimconnections.com",
"msisdn": "4474824824444",
"status": "PROCESSING",
"qrCodeLink": "https://[...]/[...].png",
"userID": "user_yf95A86RIkVxau2gzBsjV",
"accountID": "acct_ozxEbkTyvLPhhoglcALXE",
"providerID": "string",
"subscriptions": [
{
"id": "subs_BiPtvfzYKwcyNMNvTGmLO",
"status": "PROCESSING",
"esimID": "esim_kNsYsgLWJCesLTLsjoRGp",
"planID": "plan_guaGulGcrqgTYboPvetgu",
"orderID": "ordr_GMAVA4ISiqfWSG0ArGOzB",
"userID": "user_yf95A86RIkVxau2gzBsjV",
"accountID": "acct_ozxEbkTyvLPhhoglcALXE",
"expirationDate": "2026-05-04T09:42:00Z",
"createdAt": "2026-05-04T09:42:00Z",
"plan": {
"id": "plan_guaGulGcrqgTYboPvetgu",
"name": "France - 10GB - 14 days",
"scope": "LOCAL",
"category": "REGULAR",
"type": "DATA",
"isRecurring": false,
"recurringInterval": "DAILY",
"destination": {
"name": "United Kingdom",
"isoAlpha3": "GBR",
"regions": [
{
"name": "Europe",
"abbreviation": "EU"
}
],
"scopes": {
"local": true,
"regional": true,
"global": true
}
},
"region": {
"name": "Europe",
"abbreviation": "EU"
},
"dataUnit": "GB",
"dataValue": 10,
"callUnit": "MINUTES",
"callValue": 100,
"smsUnit": "SMS",
"smsValue": 100,
"durationUnit": "DAYS",
"durationValue": 14,
"features": [
{
"name": "HOTSPOT",
"category": "UTILITY"
}
],
"prices": [
{
"currencyISO": "usd",
"value": 490,
"minorUnitsExponent": 2,
"discountedFrom": 590
}
],
"createdAt": "2026-05-04T09:42:00Z"
},
"activity": {
"currentBalanceBytes": 42.0,
"spentBalanceBytes": 42.0,
"initialBalanceBytes": 42.0,
"lastUpdatedAt": "2026-05-04T09:42:00Z"
},
"cancelAtPeriodEnd": false,
"cancelEffectiveDate": "2026-05-04T09:42:00Z"
}
]
}
Response examples (401)
{
"statusCode": 401,
"message": "Unauthorized"
}
Response examples (404)
{
"statusCode": 404,
"message": "Record not found",
"error": "Not Found"
}