eSIMply catalog

List regions

Overview

List regional (multi-country, e.g. "Europe") and global eSIM groups that currently have at least one active plan.

When to Use

  • Regional plan discovery - Offer one eSIM covering several countries
  • Global coverage - Offer a single plan for most of the world

What You Get

  • Region catalog - id, title, type (regional or global), flag and covered countries
  • Starting price - startingPrice is the cheapest plan in currency; omitted when no priced plan exists

Key Features

  • Filter by type: ?type=regional or ?type=global; omit for both
  • Currency conversion: Optional Currency header converts startingPrice via liteAPI FX rates
  • Next step: Use id with GET /data/esimply/regions/{regionId}/packages
get/data/esimply/regions

Request

  • Base URL
    https://api.liteapi.travel/v3.0
  • URL
    https://api.liteapi.travel/v3.0/data/esimply/regions
  • Auth
    API key in header X-API-Key

Query parameters

type'regional' | 'global'

Filter by region type. Omit to return both.

Headers

Currencystring
Example:EUR

Optional ISO-4217 currency code. When set, priced fields are converted using liteAPI exchange rates only (not forwarded to eSIMply).

Response

OK

Example response

{
  "data": [
    {
      "id": 3,
      "title": "Europe",
      "type": "regional",
      "flag": "https://esimply-destinations-flags.s3.us-west-1.amazonaws.com/europe.svg",
      "startingPrice": 7,
      "currency": "USD",
      "countries": [
        {
          "name": "France",
          "iso2": "FR"
        },
        {
          "name": "Spain",
          "iso2": "ES"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.