esimdata: travel eSIM comparison

Find travel eSIM data plans for a destination from every provider esimdata tracks, ranked neutrally by price (or price per GB, or validity). Filter by trip length, data, unlimited, needs (hotspot, 5G, phone number, top-up, no ID check) and budget. Each result has a buy_url to the provider's page and the time the price was checked.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Destination: English name (\"Japan\"), ISO code (\"JP\") or common alias (\"UK\")."
    },
    "also_countries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "More destinations on the same trip; only plans covering all of them are returned."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Trip length: the plan must last at least this many days."
    },
    "gb": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 1000,
      "description": "Data needed in GB (unlimited plans always qualify)."
    },
    "unlimited": {
      "type": "boolean",
      "description": "true = unlimited plans only, false = no unlimited plans."
    },
    "needs": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "hotspot",
          "five_g",
          "phone_number",
          "topup",
          "no_kyc"
        ]
      },
      "description": "Plans must state these; plans that don't say are left out."
    },
    "max_price_usd": {
      "type": "number",
      "minimum": 0,
      "description": "Budget in US dollars."
    },
    "single_country_only": {
      "type": "boolean",
      "description": "Leave out regional and global plans."
    },
    "sort": {
      "type": "string",
      "enum": [
        "price",
        "price_per_gb",
        "validity"
      ],
      "description": "price (default), price_per_gb or validity (longest first)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "How many plans to return (default 10)."
    }
  },
  "required": [
    "country"
  ],
  "additionalProperties": false
}

Everything esimdata knows about one plan (by the id search_plans returned): all countries it covers, networks, policies, the provider's own page, the buy link and its price history.

{
  "type": "object",
  "properties": {
    "plan_id": {
      "type": "string",
      "description": "A plan id such as \"airalo:jp-3gb\"."
    }
  },
  "required": [
    "plan_id"
  ],
  "additionalProperties": false
}

Put 2 to 10 plans (ids from search_plans) side by side with the same fields, in the order given, to help a traveller choose.

{
  "type": "object",
  "properties": {
    "plan_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 10
    }
  },
  "required": [
    "plan_ids"
  ],
  "additionalProperties": false
}

A destination at a glance: how many plans and providers, the cheapest plan, the cheapest per GB, and which mobile networks the providers say they use there.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Destination: English name (\"Japan\"), ISO code (\"JP\") or common alias (\"UK\")."
    }
  },
  "required": [
    "country"
  ],
  "additionalProperties": false
}

Check whether a phone, tablet or watch model supports eSIM, from the manufacturer's own published list (with regional exceptions, e.g. models sold in mainland China), with the source link.

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "description": "e.g. \"iPhone 15 Pro\", \"Pixel 8\", \"Galaxy S24\"."
    }
  },
  "required": [
    "model"
  ],
  "additionalProperties": false
}

Every eSIM provider esimdata compares, with its website and whether esimdata earns a commission when a traveller buys through it (ranking never depends on it).

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}