Skip to main content
GET
/
esim
/
destinations
/
{slug}
Get Destination Details
curl --request GET \
  --url https://api.fyatu.com/api/v3/esim/destinations/{slug} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "<string>",
  "data": {
    "destination": {
      "id": "<string>",
      "slug": "<string>",
      "countryCode": "<string>",
      "title": "<string>",
      "imageUrl": "<string>",
      "packageType": "LOCAL",
      "isActive": true
    },
    "stats": {
      "operatorCount": 123,
      "packageCount": 123,
      "countriesCount": 123,
      "lowestPrice": "<string>",
      "hasVoice": true,
      "hasSms": true,
      "networkTypes": [
        "<string>"
      ]
    },
    "operators": [
      {
        "id": "<string>",
        "title": "<string>",
        "imageUrl": "<string>",
        "lowestPrice": "<string>",
        "packageCount": "<string>",
        "networkTypes": [
          "<string>"
        ],
        "isRoaming": true,
        "apnType": "<string>"
      }
    ],
    "packages": [
      {
        "packageId": "<string>",
        "slug": "<string>",
        "title": "<string>",
        "dataAmount": "<string>",
        "dataDisplay": "<string>",
        "validityDays": "<string>",
        "price": "<string>",
        "netPrice": "<string>",
        "currency": "<string>",
        "isUnlimited": true,
        "shortInfo": "<string>",
        "operatorTitle": "<string>",
        "operatorImage": "<string>",
        "voiceData": "<string>",
        "smsData": "<string>",
        "hasVoice": true,
        "hasSms": true,
        "isPremium": true,
        "planType": "data"
      }
    ],
    "countries": [
      {
        "countryCode": "<string>",
        "name": "<string>"
      }
    ]
  },
  "meta": {
    "requestId": "req_abc123def456",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

​
Overview

Retrieve detailed information about a specific destination, including all available packages, operators, and coverage information.

​
Path Parameters

ParameterTypeDescription
slugstringDestination slug (e.g., france, europe, global)

​
Response Structure

The response includes:
  • destination: Basic destination info
  • stats: Summary statistics (package count, lowest price, features)
  • operators: List of network operators
  • packages: All available packages for this destination
  • countries: Covered countries (for regional/global destinations)

​
Example Response

{
  "destination": {
    "id": 123,
    "slug": "france",
    "countryCode": "FR",
    "title": "France",
    "imageUrl": "https://cdn.fyatu.com/flags/fr.svg",
    "packageType": "LOCAL"
  },
  "stats": {
    "operatorCount": 3,
    "packageCount": 15,
    "lowestPrice": 4.50,
    "hasVoice": true,
    "hasSms": false,
    "networkTypes": ["4G", "LTE", "5G"]
  },
  "operators": [...],
  "packages": [...],
  "countries": []
}

​
Example Usage

const slug = 'france';

const response = await fetch(`https://api.fyatu.com/api/v3/esim/destinations/${slug}`, {
  headers: {
    'Authorization': `Bearer ${accessToken}`
  }
});

const { data } = await response.json();

// Show destination overview
console.log(`${data.destination.title}`);
console.log(`${data.stats.packageCount} packages from $${data.stats.lowestPrice}`);
console.log(`Networks: ${data.stats.networkTypes.join(', ')}`);

// Display packages grouped by tier
const standardPackages = data.packages.filter(p => !p.isPremium && !p.isUnlimited);
const premiumPackages = data.packages.filter(p => p.isPremium);
const unlimitedPackages = data.packages.filter(p => p.isUnlimited);

​
Regional/Global Destinations

For regional and global destinations, the countries array lists all covered countries: 
{
  "countries": [
    {
      "code": "FR",
      "name": "France",
      "networks": ["Orange", "SFR", "Bouygues"]
    },
    {
      "code": "DE",
      "name": "Germany",
      "networks": ["T-Mobile", "Vodafone"]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

JWT access token obtained from /auth/token

Path Parameters

​
slug
string
required

Destination slug (e.g., 'france', 'europe')

Response

Destination details retrieved successfully

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
​
data
object
​
meta
object