Overview

Retrieve the list of countries and regions where eSIM data packages are available. Use this as the entry point for destination pickers in your app or website.

When to Use

• Destination picker - Populate a list of countries travelers can buy eSIM coverage for
• Featured destinations - Highlight featured or package destinations in marketing UI
• Localized catalogs - Request English or French destination names with lang

What You Get

• Destination list - ISO codes, display names, flags, and cover images
• Grouped destinations - Optional grouped catalog entries for multi-country packages
• Feature flags - isPackage and isFeatured for UI prioritization

Key Features

• Language support: Optional lang=en|fr for localized names
• Sandbox vs production: sand_* keys hit the eSIMply sandbox; prod_* keys hit production
• Access control: Requires esimply_access enabled on the partner account

{
  "data": {
    "destinations": [
      {
        "iso2": "MA",
        "iso3": "MAR",
        "name": "Morocco",
        "flag": "https://esimply-destinations-flags.s3.us-west-1.amazonaws.com/ma.svg",
        "imageCover": "",
        "isPackage": false,
        "isFeatured": true
      }
    ],
    "destinationsGroup": [
      {
        "iso2": "EURMED",
        "iso3": "EURMED",
        "name": "Euro-Mediterranean",
        "flag": "https://esimply-destinations-flags.s3.us-west-1.amazonaws.com/global.svg",
        "imageCover": "",
        "isPackage": true,
        "isFeatured": false
      }
    ]
  }
}