---
title: "List eSIMply destinations"
method: GET
path: "/data/esimply/destinations"
tags: ["eSIMply catalog"]
---

# List eSIMply destinations

`GET /data/esimply/destinations`

## Request

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

## 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

## Query parameters

- `lang` 'en' | 'fr'

## Response `200`

Destinations retrieved successfully

- object
  - `data` DestinationsResponse, required
    - `destinations` Destination[]
      - `iso2` string
      - `iso3` string
      - `name` string
      - `flag` string, uri
      - `imageCover` string, uri
      - `isPackage` boolean
      - `isFeatured` boolean
    - `destinationsGroup` Destination[]
      - `iso2` string
      - `iso3` string
      - `name` string
      - `flag` string, uri
      - `imageCover` string, uri
      - `isPackage` boolean
      - `isFeatured` boolean

## Other responses

- `400`: Invalid query parameters
- `401`: Authentication required
- `403`: eSIMply access not enabled for this account

---

[API](https://skmtc.dev/liteapi/apis/api-esimply.md) - [All operations](https://skmtc.dev/liteapi/apis/api-esimply/llms.txt) - [OpenAPI document](https://skmtc.dev/liteapi/apis/api-esimply/revisions/b0fb431f4daf?raw)