Previous value: -"Localized \"from\" price string."New value: +"Lowest price in this result set, shop-formatted (per-day plans count with their day price)."

Added value: +{
+  "description": "Present when part of the request could not be honoured (e.g. more than 5 destinations).",
+  "type": "string"
+}

Added value: +{
+  "description": "Date the plan was last updated in the catalogue (YYYY-MM-DD).",
+  "type": "string"
+}

Removed value: -{
-  "description": "Date the plan facts were last synchronised from the supplier (YYYY-MM-DD), when known.",
-  "type": "string"
-}

Added value: +{
+  "description": "Optional language-region bucket the customer shops in, e.g. \"en-gb\", \"de-de\". Wins over language; prices and links are quoted in it.",
+  "type": "string"
+}

Previous value: -"Optional ISO 4217 override for the headline \"from\" price. Normally derived from language."New value: +"Optional ISO 4217 code. Every price in the result is quoted in it."

Previous value: -"Country or region in English, e.g. \"Thailand\", \"Japan\", \"Europe\", or a 2-letter ISO code. If the user names a city (e.g. \"Tokyo\"), pass its country (\"Japan\")."New value: +"Country or region in any language, e.g. \"Thailand\", \"Japon\", \"Europa\", or a 2-letter ISO code. For a city, pass its country."

Added value: +{
+  "description": "Several countries for one trip; only plans covering ALL of them are returned. Overrides destination.",
+  "items": {
+    "type": "string"
+  },
+  "maxItems": 5,
+  "type": "array"
+}

Previous value: -"ISO language of the conversation, e.g. en, de, ja, th. Sets the landing-page language and currency."New value: +"ISO language of the conversation, e.g. en, de, ja. Plan names and country names come back in it when available. Bare \"en\" is quoted in en-us / USD."

Added value: +{
+  "description": "Plans to return. Default 10; all_plans_url lists everything.",
+  "maximum": 50,
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Only plans valid for at least this many days (Unlimited Flex counts when days_range allows it).",
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "value = best price per GB / cheapest Flex first (default); price = cheapest first; data = most data first.",
+  "enum": [
+    "value",
+    "price",
+    "data"
+  ],
+  "type": "string"
+}

Previous value: -[
-  "destination"
-]New value: +[]

Added value: +{
+  "description": "How each requested destination was understood.",
+  "items": {
+    "additionalProperties": true,
+    "properties": {
+      "iso": {
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "query": {
+        "type": "string"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +"Resolved ISO code or region slug of the (first) destination."

Added value: +"Present when nothing matched: says why and what to try."

Added value: +"One eSIM plan. Every field is present only when the catalogue holds a value for it; an absent field is unknown, never \"no\"."

Added value: +{
+  "description": "\"install\": validity and billing start the moment the eSIM is installed — install only when ready to use. \"first_connection\": the eSIM can be installed before travel; validity starts on first connection to a network at the destination.",
+  "enum": [
+    "install",
+    "first_connection"
+  ],
+  "type": "string"
+}

Previous value: -"Unlimited Flex / Daily Pack: reduced rate after the daily allowance. Empty when the plan has a speed_cap (no reduction moment) or is unlimited."New value: +"Unlimited Flex / Daily Pack: reduced speed after the daily allowance, e.g. \"512 Kbit/s\". Empty when the plan has a speed_cap or is unlimited."

Added value: +{
+  "description": "APN to set when the vendor requires one.",
+  "type": "string"
+}

Added value: +{
+  "description": "Number of countries in coverage_countries.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Every country the plan works in, with the network operators per country when known.",
+  "items": {
+    "additionalProperties": true,
+    "properties": {
+      "iso": {
+        "description": "ISO 3166-1 alpha-2, lowercase.",
+        "type": "string"
+      },
+      "name": {
+        "description": "Country name in the requested language.",
+        "type": "string"
+      },
+      "networks": {
+        "description": "Operator names in that country, as the supplier lists them.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Coverage caveat to present verbatim, e.g. traffic routed via Hong Kong.",
+  "type": "string"
+}

Added value: +{
+  "description": "Present when the plan was returned for a country it covers as part of a multi-country plan: the plan's own region name.",
+  "type": "string"
+}

Added value: +"ISO 4217 currency of every price in this object."

Added value: +{
+  "description": "When the daily allowance resets, as the vendor states it (clock and time zone). Absent = resets 24 h after activation is NOT implied; simply unknown.",
+  "type": "string"
+}

Previous value: -"Data Pack: total data label."New value: +"Data Pack: total data label, e.g. \"5GB\"."

Added value: +"Data amount in GB. Meaning given by data_period."

Added value: +{
+  "description": "\"total\": data_gb is the whole plan (Data Pack). \"per_day\": data_gb is the daily full-speed allowance (Unlimited Flex, Daily Pack).",
+  "enum": [
+    "total",
+    "per_day"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Validity in days (Data Pack, Daily Pack).",
+  "type": "integer"
+}

Previous value: -"Only on price_basis \"per_day\": the durations the customer can choose, in days, e.g. \"1-30\"."New value: +"Unlimited Flex: choosable durations in days, e.g. \"1-30\"."

Removed value: -{
-  "type": "string"
-}

Added value: +{
+  "description": "Stock expiry date (YYYY-MM-DD) when the product itself has one.",
+  "type": "string"
+}

Added value: +{
+  "description": "Fair-use policy text from the supplier, when stated.",
+  "type": "string"
+}

Added value: +{
+  "description": "Hotspot / tethering rule as the vendor states it, e.g. \"Supported\" or a device limit.",
+  "type": "string"
+}

Added value: +{
+  "description": "true when the eSIM can safely be installed before departure (activation_trigger first_connection).",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Country whose internet connection the customer appears to use (IP breakout), ISO code(s) — matters for banking apps, streaming and mainland-China access. Vendor fact.",
+  "type": "string"
+}

Added value: +{
+  "description": "true when the vendor requires real-name registration (ID verification) on arrival before data works.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Date the plan facts were last synchronised from the supplier (YYYY-MM-DD), when known.",
+  "type": "string"
+}

Added value: +"Short plan name: destination · data · validity · type."

Removed value: -{
-  "description": "Speed token only (e.g. 4G/LTE/5G) — never a carrier/operator name.",
-  "type": "string"
-}

Added value: +{
+  "description": "Network technology, e.g. \"4G/LTE/5G\". Never an operator name.",
+  "type": "string"
+}

Added value: +{
+  "description": "Operator names across the plan (deduplicated). Per-country detail is in coverage_countries.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"One-sentence vendor fact to present verbatim (in the user's language) when present; overrides the generic Unlimited Flex description."New value: +"One-sentence vendor fact to present verbatim when present; overrides the generic type description."

Previous value: -"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."New value: +"Price in currency, read WITH price_basis: the full price of the plan when \"total\", the price of ONE day when \"per_day\". Never a per-GB rate. The price shown is the price paid."

Previous value: -"What `price` means. \"total\" = the whole plan (Data Pack, Daily Pack). \"per_day\" = one day (Unlimited Flex): the duration is chosen at checkout within days_range and price_max is the longest-duration price."New value: +"What `price` means."

Added value: +{
+  "description": "Always true: no tax or fee is added at checkout.",
+  "type": "boolean"
+}

Previous value: -"Only on price_basis \"per_day\": the price for the longest duration in days_range, discount already applied — the figure to quote for a full period. Absent when it cannot be computed; never infer it by multiplying price."New value: +"Only on price_basis \"per_day\": the price for the longest duration in days_range, discount applied — the figure to quote for a full period. Never infer it by multiplying."

Added value: +{
+  "description": "language-region bucket the prices and links are quoted in, e.g. \"en-us\".",
+  "type": "string"
+}

Added value: +"Product id. Use it for get_plan_details and start_checkout."

Added value: +"Average customer rating (1-5). Present only when reviews exist."

Added value: +{
+  "description": "Vendor refund/cancellation class for this plan.",
+  "enum": [
+    "until_install",
+    "non_refundable",
+    "no_cancel"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "The refund class in words - present verbatim.",
+  "type": "string"
+}

Added value: +"Number of reviews. Present only when > 0."

Added value: +{
+  "description": "Catalogue SKU.",
+  "type": "string"
+}

Previous value: -"Present only on plans with a PERMANENT speed cap, e.g. \"10 Mbit/s\": the plan always runs at up to this speed with the daily allowance in daily_high_speed. Do not call such a plan high-speed."New value: +"Present only on plans with a PERMANENT speed cap, e.g. \"10 Mbit/s\". Never call such a plan high-speed."

Added value: +{
+  "description": "true when a start date must be chosen at checkout.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Short description in the requested language, from the product page.",
+  "type": "string"
+}

Removed value: -{
-  "type": "boolean"
-}

Added value: +{
+  "description": "Full product title in the requested language.",
+  "type": "string"
+}

Added value: +true

Previous value: -"True only for data top-up (add data to a Data Pack). See topup_kind for the full picture."New value: +"Top-up possibility for this plan."

Added value: +{
+  "how": {
+    "description": "How the customer tops up.",
+    "type": "string"
+  },
+  "kind": {
+    "description": "What TopUp can add without a new eSIM: data (Data Pack), days (Unlimited Flex / Daily Pack), or none.",
+    "enum": [
+      "data",
+      "days",
+      "none"
+    ],
+    "type": "string"
+  }
+}

Previous value: -"boolean"New value: +"object"

Removed value: -{
-  "description": "What eSIM-Global.VIP TopUp can add to this plan without a new eSIM: \"data\" (Data Pack), \"days\" (Unlimited Flex / Daily Pack: extend validity), or \"none\".",
-  "enum": [
-    "data",
-    "days",
-    "none"
-  ],
-  "type": "string"
-}

Added value: +"A per-order Transparency link shows remaining data in near real-time."

Previous value: -"Data Pack, Daily Pack or Unlimited Flex."New value: +"Plan type."

Added value: +[
+  "Data Pack",
+  "Daily Pack",
+  "Unlimited Flex"
+]

Added value: +{
+  "description": "Days the eSIM may remain unused after purchase before it expires (supplier value).",
+  "type": "integer"
+}

Added value: +"Product page in pricing_bucket. Use verbatim."

Previous value: -"Data Pack: validity label."New value: +"Validity label, e.g. \"30 days\"."

Added value: +{
+  "description": "Always \"none\": data only, no telephone number, no SMS.",
+  "type": "string"
+}

Added value: +{
+  "type": "string"
+}

Added value: +{
+  "type": "integer"
+}

Added value: +{
+  "description": "Plans matched before limit; the rest are on all_plans_url.",
+  "type": "integer"
+}

Added value: +{
+  "description": "Only on price_basis \"per_day\": the durations the customer can choose, in days, e.g. \"1-30\".",
+  "type": "string"
+}

Previous value: -"Full fixed price in currency; not per-day or per-GB."New value: +"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."

Added value: +{
+  "description": "What `price` means. \"total\" = the whole plan (Data Pack, Daily Pack). \"per_day\" = one day (Unlimited Flex): the duration is chosen at checkout within days_range and price_max is the longest-duration price.",
+  "enum": [
+    "total",
+    "per_day"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Only on price_basis \"per_day\": the price for the longest duration in days_range, discount already applied — the figure to quote for a full period. Absent when it cannot be computed; never infer it by multiplying price.",
+  "type": "number"
+}