Skip to main content

Get subscription​

Fetches an IoT subscription with optionally included resources. An IoT subscription is the top-level resource identified by its IoT subscription ID. It acts as a parent resource for other subscription related resources, such as an eUICC or a profile.

Path Parameters
  • id string required

    Possible values: Value must match regular expression ^[85,97]{2}[23456789ABCDEFGHJKLMNPQRSTUVWXYZ]{16}$

    IoT subscription ID to perform request on.

Query Parameters
  • include string[]

    Possible values: [euiccs, 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.

Responses

Contains the requested IoT subscription.

Schema
  • attributes object
  • id string

    Possible values: Value must match regular expression ^[85,97]{2}[23456789ABCDEFGHJKLMNPQRSTUVWXYZ]{16}$

    Identifies the IoT subscription.

  • subscriptionType string

    Possible values: [IOT_CONNECT]

    The subscription type.

  • domain object

    The domain that owns this subscription.

  • domainId string

    Possible 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* string
  • relationships object

    Contains all relationships associated with this subscription.

  • euiccs object[]

    All eUICCs belonging to this IoT subscription.

  • url string

    Possible values: non-empty and <= 256 characters

  • attributes object
  • eid string

    Possible values: Value must match regular expression ^[0-9]{32}$

    Uniquely identifies an eUICC (eSIM).

  • enabledProfile string

    Possible values: Value must match regular expression ^89[0-9]{16,18}$

    ICCID of the currently enabled profile.

  • bootstrapProfile string

    Possible 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.

  • profiles object[]

    All profiles belonging to this IoT subscription.

  • url string

    Possible values: non-empty and <= 256 characters

  • attributes object
  • iccid string

    Possible 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 string

    Possible 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 boolean

    True 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 string

    Possible 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 string

    Possible values: [GLOBAL_SUBSCRIPTION, BR_DATORA, BR_DATORA_MULTI]

    The connectivity profile determines capabilities of a profile and its connectivity subscription.

  • name string

    Human 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 string

    Possible values: Value must match regular expression ^[0-9]{4,8}$

    Identifies the PIN code.

  • pin2 string

    Possible values: Value must match regular expression ^[0-9]{4,8}$

    Identifies the PIN code.

  • puk1 string

    Possible values: Value must match regular expression ^[0-9]{8}$

    Identifies the PUK code.

  • puk2 string

    Possible values: Value must match regular expression ^[0-9]{8}$

    Identifies the PUK code.

  • connectivitySubscriptions object[]

    All connectivity subscriptions belonging to this IoT subscription.

  • url string

    Possible values: non-empty and <= 256 characters

  • attributes object

    Attributes used to describe a connectivity subscription.

  • imsi string

    Possible values: Value must match regular expression ^[0-9]{6,15}$

    International Mobile Subscriber Identity. Uniquely identifies a subscriber in the mobile network.

  • iccid string

    Possible 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 string

    Possible 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 string

    Possible 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-time

    Time when profile entered ACTIVE mode for the first time.

  • fixedIpAddresses object[]

    Fixed IP addresses associated with this subscription.

  • ipAddress string

    Possible values: Value must match regular expression ^[a-fA-F0-9.\/:]{1,100}$

  • subnet string

    Possible values: Value must match regular expression ^[a-fA-F0-9.\/:]{1,100}$

  • ipVersion string

    Possible values: [IPv4, IPv6]

  • apnName string

    Possible values: Value must match regular expression ^[a-zA-Z0-9.]{3,256}$

  • radiusServer string
  • imei object

    IMEI related information.

  • assignedImei string

    Possible values: Value must match regular expression ^[0-9]{14,16}$

    Assigned IMEI for the subscription. Null if no assigned IMEI.

  • detectedImei string

    Possible values: Value must match regular expression ^[0-9]{14,16}$

    Detected IMEI for the subscription. Null if no detected IMEI.

Loading...