IbiPoint eSIM Catalog

Find IbiPoint eSIM plans for a destination (country or region). Returns the best-value plans sorted by IbiPoint Data Rating, with prices and a direct link. Use when a user wants mobile data abroad.

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string",
      "description": "Country or region, e.g. \"Thailand\", \"Japan\", \"Europe\". City names are mapped to their country."
    },
    "type": {
      "type": "string",
      "enum": [
        "data_pack",
        "unlimited_flex",
        "any"
      ],
      "description": "Plan type. Default any."
    },
    "currency": {
      "type": "string",
      "description": "Optional ISO 4217 override for the headline \"from\" price. Normally derived from language."
    },
    "language": {
      "type": "string",
      "description": "ISO language of the conversation, e.g. en, de, ja, th. Sets the landing-page language and currency."
    }
  },
  "required": [
    "destination"
  ]
}

{
  "type": "object",
  "properties": {
    "destination": {
      "type": "string"
    },
    "iso": {
      "type": "string"
    },
    "covered": {
      "type": "boolean"
    },
    "from_price": {
      "type": "string",
      "description": "Localized \"from\" price string."
    },
    "currency": {
      "type": "string"
    },
    "plans": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "product_id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "description": "Data Pack or Unlimited Flex."
          },
          "network": {
            "type": "string",
            "description": "Speed token only (e.g. 4G/LTE/5G) — never a carrier/operator name."
          },
          "topup": {
            "type": "boolean"
          },
          "price": {
            "type": "number",
            "description": "Price in currency, to be read WITH price_basis: the full fixed price of the plan when price_basis is \"total\", the price of one day when it is \"per_day\". Never a per-GB rate."
          },
          "price_basis": {
            "type": "string",
            "enum": [
              "total",
              "per_day"
            ],
            "description": "What `price` means. \"total\" = the whole plan (Data Pack). \"per_day\" = one day (Unlimited Flex): the duration is chosen at checkout within days_range; see price_30_days and price_max."
          },
          "days_range": {
            "type": "string",
            "description": "Only on price_basis \"per_day\": the durations the customer can choose, in days, e.g. \"1-365\"."
          },
          "price_30_days": {
            "type": "number",
            "description": "Only on price_basis \"per_day\": the price for 30 days with the duration discount applied — the reference figure to quote for a stay of about a month. Absent when it cannot be computed; never infer it by multiplying price."
          },
          "price_max": {
            "type": "number",
            "description": "Only on price_basis \"per_day\": the price for the longest duration in days_range, discount applied. Absent when it cannot be computed; never infer it by multiplying price."
          },
          "currency": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "review_count": {
            "type": "integer"
          },
          "rating": {
            "type": "number"
          },
          "data_gb": {
            "type": "number"
          },
          "data": {
            "type": "string",
            "description": "Data Pack: total data label."
          },
          "validity": {
            "type": "string",
            "description": "Data Pack: validity label."
          },
          "daily_high_speed": {
            "type": "string",
            "description": "Unlimited Flex: daily high-speed allowance."
          },
          "always_on_rate": {
            "type": "string",
            "description": "Unlimited Flex: reduced rate after the daily allowance."
          },
          "transparency": {
            "type": "boolean"
          },
          "tethering": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          }
        }
      }
    },
    "all_plans_url": {
      "type": "string"
    },
    "message": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Full details for one IbiPoint plan by product id: data, validity, network, top-up support, transparency, reviews and link.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "integer",
      "description": "WooCommerce product id from search_esim_plans."
    },
    "language": {
      "type": "string",
      "description": "ISO language of the conversation. Sets the landing-page language/currency of the link."
    }
  },
  "required": [
    "product_id"
  ]
}

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "integer"
    },
    "name": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "description": "Data Pack or Unlimited Flex."
    },
    "network": {
      "type": "string",
      "description": "Speed token only (e.g. 4G/LTE/5G) — never a carrier/operator name."
    },
    "topup": {
      "type": "boolean"
    },
    "price": {
      "type": "number",
      "description": "Price in currency, to be read WITH price_basis: the full fixed price of the plan when price_basis is \"total\", the price of one day when it is \"per_day\". Never a per-GB rate."
    },
    "price_basis": {
      "type": "string",
      "enum": [
        "total",
        "per_day"
      ],
      "description": "What `price` means. \"total\" = the whole plan (Data Pack). \"per_day\" = one day (Unlimited Flex): the duration is chosen at checkout within days_range; see price_30_days and price_max."
    },
    "days_range": {
      "type": "string",
      "description": "Only on price_basis \"per_day\": the durations the customer can choose, in days, e.g. \"1-365\"."
    },
    "price_30_days": {
      "type": "number",
      "description": "Only on price_basis \"per_day\": the price for 30 days with the duration discount applied — the reference figure to quote for a stay of about a month. Absent when it cannot be computed; never infer it by multiplying price."
    },
    "price_max": {
      "type": "number",
      "description": "Only on price_basis \"per_day\": the price for the longest duration in days_range, discount applied. Absent when it cannot be computed; never infer it by multiplying price."
    },
    "currency": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "review_count": {
      "type": "integer"
    },
    "rating": {
      "type": "number"
    },
    "data_gb": {
      "type": "number"
    },
    "data": {
      "type": "string",
      "description": "Data Pack: total data label."
    },
    "validity": {
      "type": "string",
      "description": "Data Pack: validity label."
    },
    "daily_high_speed": {
      "type": "string",
      "description": "Unlimited Flex: daily high-speed allowance."
    },
    "always_on_rate": {
      "type": "string",
      "description": "Unlimited Flex: reduced rate after the daily allowance."
    },
    "transparency": {
      "type": "boolean"
    },
    "tethering": {
      "type": "boolean"
    },
    "description": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Hand the customer to the IbiPoint shop to buy one plan. Returns buy_url (the product page where they tap Buy now to pay securely — card, Apple Pay, Google Pay, with an optional discount code) plus the plan name and price. No account needed; the eSIM is emailed right after payment. There is no in-chat order tracking.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "integer",
      "description": "WooCommerce product id to buy."
    },
    "language": {
      "type": "string",
      "description": "ISO language of the conversation. Sets the language/currency of the payment page."
    }
  },
  "required": [
    "product_id"
  ]
}

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string"
    },
    "price": {
      "type": "number",
      "description": "Price in currency, to be read WITH price_basis: the full fixed price when \"total\", the price of one day when \"per_day\"."
    },
    "price_basis": {
      "type": "string",
      "enum": [
        "total",
        "per_day"
      ],
      "description": "What `price` means for this product. See the plan schema."
    },
    "days_range": {
      "type": "string",
      "description": "Only on price_basis \"per_day\": choosable durations in days, e.g. \"1-365\"."
    },
    "price_30_days": {
      "type": "number",
      "description": "Only on price_basis \"per_day\": price for 30 days, discount applied — the reference figure for a month."
    },
    "price_max": {
      "type": "number",
      "description": "Only on price_basis \"per_day\": price for the longest duration, discount applied."
    },
    "currency": {
      "type": "string"
    },
    "buy_url": {
      "type": "string",
      "description": "The exact product page to send the customer to. Use verbatim."
    },
    "app_links": {
      "type": "object",
      "description": "Optional links to the free IbiPoint app (android/ios). Mention only when present."
    },
    "message": {
      "type": "string"
    }
  },
  "additionalProperties": true
}