Siima eSIM

Search prepaid travel eSIM data plans by destination country (ISO 3166-1 alpha-2, e.g. "JP"), region (e.g. "Europe"), minimum data in GB, maximum total price, or plan duration in days. Plans come in three coverage types: "country" (one country), "regional" (a named multi-country area such as "Europe+" or "South East Asia"), and "global" (worldwide). A country filter matches every plan that covers it, of any coverage type — so searching country="FR" returns France-only plans alongside the Europe and worldwide plans that include France. For a trip through several countries, filter coverage_type="regional" or "global" to get one eSIM for the whole route; for a single-country trip a "country" plan is usually cheapest. Returned price is the final amount the customer pays at checkout (all fees included), in the requested currency. To buy: call create_checkout_link with the plan id, give the returned URL to the user. They confirm their email with a 6-digit code and pay there; nothing is ordered until they do. After payment the eSIM (QR code + activation link + manual codes) is emailed to them automatically — no account needed.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "Destination country as ISO 3166-1 alpha-2 code, e.g. \"JP\" for Japan. Matches plans of any coverage type that include it."
    },
    "region": {
      "type": "string",
      "description": "Region name, e.g. \"Europe\", \"Asia\""
    },
    "coverage_type": {
      "type": "string",
      "enum": [
        "country",
        "regional",
        "global"
      ],
      "description": "Restrict to single-country plans, multi-country regional plans, or worldwide plans"
    },
    "coverage": {
      "type": "string",
      "description": "Exact coverage area name for a regional or worldwide plan, e.g. \"Europe+\", \"CENAM\", \"Global\" — get valid names from list_regions"
    },
    "min_data_gb": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Minimum data allowance in GB"
    },
    "max_price": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Maximum total price in the requested currency (checkout total)"
    },
    "duration_days": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Exact plan duration in days"
    },
    "currency": {
      "type": "string",
      "enum": [
        "usd",
        "eur",
        "gbp"
      ],
      "default": "usd",
      "description": "Currency for prices: \"usd\", \"eur\", or \"gbp\". Defaults to \"usd\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "Max results to return"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch full details of a single Siima eSIM plan by its id (from search_esim_plans). To buy: call create_checkout_link with the plan id, give the returned URL to the user. They confirm their email with a 6-digit code and pay there; nothing is ordered until they do. After payment the eSIM (QR code + activation link + manual codes) is emailed to them automatically — no account needed.

{
  "type": "object",
  "properties": {
    "plan_id": {
      "type": "string",
      "format": "uuid",
      "description": "Plan id returned by search_esim_plans"
    },
    "currency": {
      "type": "string",
      "enum": [
        "usd",
        "eur",
        "gbp"
      ],
      "default": "usd",
      "description": "Currency for prices: \"usd\", \"eur\", or \"gbp\". Defaults to \"usd\"."
    }
  },
  "required": [
    "plan_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Create a secure payment link on siima.online for a Siima eSIM plan (Stripe-powered, but hosted on our own site — never a redirect to checkout.stripe.com). Give the returned url to the user to complete payment. Optionally pass the buyer's email to pre-fill the checkout form. The buyer confirms it with a 6-digit code we email them, then pays — nothing is ordered until they do. After payment, the eSIM QR code, one-tap activation link, and manual installation codes are emailed to the buyer within a minute. No account or signup is required.

{
  "type": "object",
  "properties": {
    "plan_id": {
      "type": "string",
      "format": "uuid",
      "description": "Plan id from search_esim_plans"
    },
    "email": {
      "type": "string",
      "format": "email",
      "description": "Buyer email to pre-fill at checkout (they verify it before paying; the eSIM is delivered there)"
    },
    "currency": {
      "type": "string",
      "enum": [
        "usd",
        "eur",
        "gbp"
      ],
      "default": "usd",
      "description": "Currency for prices: \"usd\", \"eur\", or \"gbp\". Defaults to \"usd\"."
    }
  },
  "required": [
    "plan_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List all countries Siima sells a single-country eSIM plan for, with plan counts and the cheapest total price per country. Country codes are ISO 3166-1 alpha-2. Counts and prices cover country plans only, so they stay comparable — many more countries are reachable via multi-country plans; call list_regions for those.

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "enum": [
        "usd",
        "eur",
        "gbp"
      ],
      "default": "usd",
      "description": "Currency for prices: \"usd\", \"eur\", or \"gbp\". Defaults to \"usd\"."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List every multi-country coverage area Siima sells — regional areas such as "Europe+", "South East Asia" or "CENAM", and worldwide plans — with the countries each one covers, how many plans it has, and its cheapest total price. Use this for a trip crossing several countries: pick a coverage area whose country list contains the whole itinerary, then pass its name as `coverage` to search_esim_plans. For a single-country trip use list_destinations instead.

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "enum": [
        "usd",
        "eur",
        "gbp"
      ],
      "default": "usd",
      "description": "Currency for prices: \"usd\", \"eur\", or \"gbp\". Defaults to \"usd\"."
    },
    "country": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "Only return coverage areas that include this ISO 3166-1 alpha-2 country, e.g. \"IT\""
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}