GET /subscriptions/

Returns a list of all Subscriptions associated with the account

Responses

  • 200 application/json

    Subscriptions fetched successfully

    Hide response attributes Show response attributes object
    • id string

      The Subscription's ID

    • esimID string

      The associated eSIM ID

    • plan object
      Hide plan attributes Show plan attributes object
      • id string
      • destination object
        Hide destination attributes Show destination attributes object
        • name string
        • isoAlpha3 string
      • region object
        Hide region attributes Show region attributes object
        • name string
        • abbreviation string
      • dataUnit string

        Possible values:

        • MB - MegaByte representation
        • GB - GigaByte representation

        Values are MB or GB.

      • dataValue number

        Details:

        • If dataValue >= 0 then the plan is capped to that amount of consumable data
        • If dataValue == -1 then the plan is unlimited and does not have a cap on consumable data
      • callUnit string

        Details:

        • MINUTES - Minutes representation
        • HOURS - Hours representation

        Values are MINUTES or HOURS.

      • callValue number

        Details:

        • If callValue >= 0 then the plan is capped to that amount of consumable call time
        • If callValue == -1 then the plan is unlimited and does not have a cap on call time
      • smsUnit string
      • smsValue number

        Details:

        • If smsValue >= 0 then the plan is capped to that amount of consumable SMS sent
        • If smsValue == -1 then the plan is unlimited and does not have a cap on SMS sent
      • durationUnit string
      • durationValue number
      • features array[object]
        Hide features attributes Show features attributes object
        • name string

          Possible values:

          • HOTSPOT - The plan does support the hotspot function
          • TOP_UP - The plan does support top up operations
          • 3G - The plan and its associated network supports speeds up to 3G
          • 4G - The plan and its associated network supports speeds up to 4G
          • 5G - The plan and its associated network supports speeds up to 5G

          Values are HOTSPOT, TOP_UP, 3G, 4G, or 5G.

        • category string

          Values are UTILITY, BILLING, or NETWORK.

      • prices array[object]
        Hide prices attributes Show prices attributes object
        • currencyISO string
        • value number

          The unit amount in cents (if supported), represented as a signed integer

        • minorExponentUnits number

          Indicates the number of decimals in the price for currencies supporting this format or 0 for zero-decimal currencies such as JPY. Examples:

          • A USD price value of 490 with a minorExponentUnits of 2 would be $4.90
          • A JPY price value of 775 with a minorExponentUnits of 0 would be ¥775
    • status string

      Statuses:

      • PROCESSING - The Subscription is being processed and should be ready soon
      • PENDING - The Subscription is ready and is pending first use by the User
      • ACTIVE - The Subscription is currently active and used by the User
      • EXPIRED - The Subscription has expired and is no longer valid
      • CANCELLED - The Subscription has been cancelled by the User
      • DEPLETED - The allocation of the Subscription has been fully consumed by the User

      Values are PROCESSING, PENDING, ACTIVE, EXPIRED, CANCELLED, or DEPLETED.

GET /subscriptions/
curl \
 --request GET 'https://zim.api.dev.zimconnections.com/subscriptions/' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
[
  {
    "id": "sub_igFqGZhkRTHb0UNiRuAAA",
    "plan": {
      "id": "plan_igFqGZhkRTHb0UNiRuAAA",
      "dataUnit": "GB",
      "dataValue": 10
    },
    "esimID": "esim_igFqGZhkRTHb0UNiRuAAA",
    "status": "ACTIVE"
  },
  {
    "id": "sub_igFqGZhkRTHb0UNiRuBBB",
    "plan": {
      "id": "plan_igFqGZhkRTHb0UNiRuBBB",
      "dataUnit": "GB",
      "dataValue": 5
    },
    "esimID": "esim_igFqGZhkRTHb0UNiRuBBB",
    "status": "DEPLETED"
  }
]