eSIMply catalog

List packages for a destination

Overview

Retrieve available eSIM data packages for a specific destination, including data size, validity, and pricing.

When to Use

  • Package selection UI - Show travelers the plans available for a chosen country
  • Price display - Present selling prices in the traveler's preferred currency
  • Inventory checks - Confirm which packages can be added to a cart

What You Get

  • Package catalog - Name, data size (MB), validity days, and package IDs
  • Pricing - calculatedPrice, optional b2bPrice, and currency
  • Destination branding - Flag URL for UI display

Key Features

  • Currency conversion: Optional Currency header converts prices via liteAPI FX rates
  • Destination-scoped: Pass the destination ISO2/code from the destinations list
  • Ready for cart: Use packageId with create-cart to start a purchase
get/data/esimply/destinations/{destinationCode}/packages

Request

  • Base URL
    https://api.liteapi.travel/v3.0
  • URL
    https://api.liteapi.travel/v3.0/data/esimply/destinations/{destinationCode}/packages
  • Auth
    API key in header X-API-Key

Path parameters

destinationCodestring required
Example:MA

Destination code (typically ISO2)

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

Packages retrieved successfully

Example response

{
  "data": [
    {
      "packageId": 1,
      "name": "1 GB",
      "dataSizeMb": 1024,
      "validityDays": 7,
      "providerId": 4,
      "calculatedPrice": 3,
      "b2bPrice": 3.46,
      "currency": "EUR",
      "destinationFlag": "https://esimply-destinations-flags.s3.us-west-1.amazonaws.com/ma.svg"
    }
  ]
}

Changes

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