Get eUICC
Fetches an eUICC with optionally included resources. An eUICC always belongs to one IoT subscription. The eUICC can have one or more profiles and connectivity subscriptions.
Path Parameters
- eid string required
Possible values: Value must match regular expression
^[0-9]{32}$
EID to perform request on.
Query Parameters
- include string[]
Possible values: [
iotSubscription
,profiles
,connectivitySubscriptions
]Related resources to include in response. Format as a comma separated list. Omitting this query parameter means that no related resources will be included in response. Note that including resources may result in longer response times so only include what you actually need.
- 200
- 400
- 401
- 404
- 500
Contains the requested eUICC.
- application/json
- Schema
- Example (from schema)
Schema
attributes object
eid stringPossible values: Value must match regular expression
^[0-9]{32}$
Uniquely identifies an eUICC (eSIM).
enabledProfile stringPossible values: Value must match regular expression
^89[0-9]{16,18}$
ICCID of the currently enabled profile.
bootstrapProfile stringPossible values: Value must match regular expression
^89[0-9]{16,18}$
ICCID of the bootstrap profile, i.e. the profile that was first enabled on this eUICC.
relationships object
iotSubscription object
References an IoT subscription that is related to this resource. The
url
property can be used to GET the resource. Theattributes
property will be null unless the query parameterinclude
specifies the inclusion of this resource. If present, theattributes
property will only contain properties marked as required.url stringPossible values:
non-empty
and<= 256 characters
attributes object
id stringPossible values: Value must match regular expression
^[85,97]{2}[23456789ABCDEFGHJKLMNPQRSTUVWXYZ]{16}$
Identifies the IoT subscription.
subscriptionType stringPossible values: [
IOT_CONNECT
]The subscription type.
domain object
The domain that owns this subscription.
domainId stringPossible values: Value must match regular expression
^([A-Za-z0-9]{8}-){0,6}[A-Za-z0-9]{8}$
Domain the resource belongs to. Used to determine which users have access to the resource.
metadata object
All metadata key-value pairs associated with this subscription. This object contains dynamic properties since metadata has a customized definition process.
property name*
stringprofiles object[]
All profiles belonging to this eUICC.
url stringPossible values:
non-empty
and<= 256 characters
attributes object
iccid stringPossible values: Value must match regular expression
^89[0-9]{16,18}$
Integrated Circuit Card ID. Uniquely identifies a UICC (SIM card) or an eUICC profile.
profileType stringPossible values: [
SIM_PROFILE
,VIRTUAL_PROFILE
]Specifies the type of profile.
SIM_PROFILE
means the profile resides on a UICC.VIRTUAL_PROFILE
means the profile resides on an eUICC.isEnabled booleanTrue if this is the currently enabled profile on an eUICC or if this is on a UICC. False if this is a disabled profile on an eUICC.
cmp stringPossible values: [
IOTA_EU
,ARQIA_BR
]The profile's Connectivity Management Platform (CMP) determines which underlying connectivity platform the profile belongs to and determines what kind of data is available for the profile and its connectivity subscription.
connectivityProfile object
id stringPossible values: [
GLOBAL_SUBSCRIPTION
,BR_DATORA
,BR_DATORA_MULTI
]The connectivity profile determines capabilities of a profile and its connectivity subscription.
name stringHuman readable name of the connectivity profile.
pinPuk object
PIN and PUK information. Only available if specified using the
extendWith
query parameter. This property is only available for profiles on the IOTA_EU connectivity management platform.pin1 stringPossible values: Value must match regular expression
^[0-9]{4,8}$
Identifies the PIN code.
pin2 stringPossible values: Value must match regular expression
^[0-9]{4,8}$
Identifies the PIN code.
puk1 stringPossible values: Value must match regular expression
^[0-9]{8}$
Identifies the PUK code.
puk2 stringPossible values: Value must match regular expression
^[0-9]{8}$
Identifies the PUK code.
connectivitySubscriptions object[]
All connectivity subscriptions belonging to this eUICC.
url stringPossible values:
non-empty
and<= 256 characters
attributes object
Attributes used to describe a connectivity subscription.
imsi stringPossible values: Value must match regular expression
^[0-9]{6,15}$
International Mobile Subscriber Identity. Uniquely identifies a subscriber in the mobile network.
iccid stringPossible values: Value must match regular expression
^89[0-9]{16,18}$
Integrated Circuit Card ID. Uniquely identifies a UICC (SIM card) or an eUICC profile.
msisdn stringPossible values: Value must match regular expression
^[0-9]{5,15}$
Mobile Station International Subscriber Directory Number. This is equivalent to the phone number, including the country code.
mode stringPossible values: [
ACTIVE
,ACTIVE_NO_BILLING
,DEACTIVATED
,PAUSED
,TERMINATED
]The mode of the subscription. This determines whether the subscription can connect to the network and how the subscription is billed.
firstActivationDate date-timeTime when profile entered ACTIVE mode for the first time.
fixedIpAddresses object[]
Fixed IP addresses associated with this subscription.
ipAddress stringPossible values: Value must match regular expression
^[a-fA-F0-9.\/:]{1,100}$
subnet stringPossible values: Value must match regular expression
^[a-fA-F0-9.\/:]{1,100}$
ipVersion stringPossible values: [
IPv4
,IPv6
]apnName stringPossible values: Value must match regular expression
^[a-zA-Z0-9.]{3,256}$
radiusServer stringimei object
IMEI related information.
assignedImei stringPossible values: Value must match regular expression
^[0-9]{14,16}$
Assigned IMEI for the subscription. Null if no assigned IMEI.
detectedImei stringPossible values: Value must match regular expression
^[0-9]{14,16}$
Detected IMEI for the subscription. Null if no detected IMEI.
{
"attributes": {
"eid": "89000000000000000000000000000001",
"enabledProfile": "89000000000000000001",
"bootstrapProfile": "89000000000000000001"
},
"relationships": {
"iotSubscription": {
"url": "/iot-connect/subscriptions/v1/iot-subscriptions/9746U5LX6B24P3AZ8X"
},
"profiles": [
{
"url": "/iot-connect/subscriptions/v1/profiles/89000000000000000001"
}
],
"connectivitySubscriptions": [
{
"url": "/iot-connect/subscriptions/v1/connectivity-subscriptions/230000000000001"
}
]
}
}
BadRequest
Response Headers
Access-Control-Allow-Origin string
Access-Control-Allow-Methods string
Access-Control-Allow-Headers string
- application/json
- Schema
- Example (from schema)
Schema
- name string
- message string
errors object[]
message stringerrorCode stringpath stringOptional path, usually used to describe which incoming parameters are not valid.
{
"name": "string",
"message": "string",
"errors": [
{
"message": "string",
"errorCode": "string",
"path": "string"
}
]
}
Unauthorized. Your token is not valid.
Response Headers
Access-Control-Allow-Origin string
Access-Control-Allow-Methods string
Access-Control-Allow-Headers string
- application/json
- Schema
- Example (from schema)
Schema
- name string
- message string
errors object[]
message stringerrorCode stringpath stringOptional path, usually used to describe which incoming parameters are not valid.
{
"name": "string",
"message": "string",
"errors": [
{
"message": "string",
"errorCode": "string",
"path": "string"
}
]
}
The specified resource was not found
Response Headers
Access-Control-Allow-Origin string
Access-Control-Allow-Methods string
Access-Control-Allow-Headers string
- application/json
- Schema
- Example (from schema)
Schema
- name string
- message string
errors object[]
message stringerrorCode stringpath stringOptional path, usually used to describe which incoming parameters are not valid.
{
"name": "string",
"message": "string",
"errors": [
{
"message": "string",
"errorCode": "string",
"path": "string"
}
]
}
Internal Server Error
Response Headers
Access-Control-Allow-Origin string
Access-Control-Allow-Methods string
Access-Control-Allow-Headers string
- application/json
- Schema
- Example (from schema)
Schema
- name string
- message string
errors object[]
message stringerrorCode stringpath stringOptional path, usually used to describe which incoming parameters are not valid.
{
"name": "string",
"message": "string",
"errors": [
{
"message": "string",
"errorCode": "string",
"path": "string"
}
]
}