Get unlimited local Plans for a Destination

GET /plans/{iso3}/local/unlimited

Returns the unlimited (no data cap, dataValue == -1) local Plans available for a specific Destination. Optionally filtered by planType.

Path parameters

  • iso3 string Required

    ISO Alpha-3 code of the Destination

Query parameters

  • discountCode string

    Optional discount code applied to the returned Plan prices

  • planType string

    Optional filter on the Plan type:

    • DATA - Data-only Plans
    • VOICE_AND_DATA - Plans including voice (and SMS) in addition to data

    Values are DATA or VOICE_AND_DATA.

Responses

  • 200 application/json

    Unlimited local Plans fetched successfully

    Hide response attributes Show response 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
GET /plans/{iso3}/local/unlimited
curl \
 --request GET 'https://zim.api.zimconnections.com/plans/{iso3}/local/unlimited' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "X-App-Identifier: $API_KEY"
Response examples (200)
[
  {
    "id": "plan_uNlimitedABCDEF123456",
    "destination": {
      "name": "France",
      "isoAlpha3": "FRA"
    },
    "dataUnit": "GB",
    "dataValue": -1,
    "durationUnit": "DAYS",
    "durationValue": 7,
    "features": [
      {
        "name": "HOTSPOT",
        "category": "UTILITY"
      },
      {
        "name": "5G",
        "category": "NETWORK"
      }
    ],
    "prices": [
      {
        "currencyISO": "USD",
        "value": 2490,
        "minorExponentUnits": 2
      }
    ]
  },
  {
    "id": "plan_uNlimitedABCDEF654321",
    "destination": {
      "name": "France",
      "isoAlpha3": "FRA"
    },
    "dataUnit": "GB",
    "dataValue": -1,
    "durationUnit": "DAYS",
    "durationValue": 30,
    "features": [
      {
        "name": "HOTSPOT",
        "category": "UTILITY"
      },
      {
        "name": "5G",
        "category": "NETWORK"
      }
    ],
    "prices": [
      {
        "currencyISO": "USD",
        "value": 4990,
        "minorExponentUnits": 2
      }
    ]
  }
]