API v2.4 / eSIMs / Get eSIM details

Server eSIM Go API - https://api.esim-go.com/v2.4

GET

/esims/{iccid}

• eSIM Go API

This endpoint allows you to retrieve detailed information about a specific eSIM using its ICCID (Integrated Circuit Card Identifier).

Authorizations

• apikeyAuth

Parameters

Path Parameters

iccid

required

string

(Required) The ICCID of the eSIM

Example

8944123456789012000

Query Parameters

additionalFields

string

Example

appleInstallUrl

Responses

200

OK

object

iccid

The Integrated Circuit Card Identifier of the SIM card

string

894123456789123456

pin

The Personal Identification Number for the SIM card

string

0000

puk

The Personal Unblocking Key for the SIM card

string

123445678

matchingId

A unique identifier for matching purposes (used for eSIM activation)

string

JQ-123456-ABCDEPFX

smdpAddress

The Subscription Manager Data Preparation server address (used for eSIM activation)

string

http://rsp.example.com

profileStatus

The current status of the SIM profile

string

Installed

firstInstalledDateTime

The timestamp of when the profile was first installed (in milliseconds since epoch)

integer format: int64

1723541877280

customerRef

Customer reference information

string

400

Bad Request - returned when request format is not accepted

object

message

Status of api functions which do not return data

string

403

Unauthorised - returned when the api token is invalid; the user does not have any available Bundles left or the ICCID is not accessible by the user

object

message

Status of api functions which do not return data

string

429

Too Many Requests

object

message

Status of api functions which do not return data

string

500

Server Error

object

message

Status of api functions which do not return data

string

503

Processing - Please come back later or use the Retry-After (seconds) header

object

message

Status of api functions which do not return data

string