Skip to main content
GET
/
esim
/
packages
/
{packageId}
Get Package Details
curl --request GET \
  --url https://api.fyatu.com/api/v3/esim/packages/{packageId} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "<string>",
  "data": {
    "packageId": "<string>",
    "slug": "<string>",
    "name": "<string>",
    "tier": "standard",
    "destination": {
      "slug": "<string>",
      "name": "<string>",
      "countryCode": "<string>",
      "type": "local",
      "imageUrl": "<string>"
    },
    "data": {
      "amount": 123,
      "display": "<string>",
      "isUnlimited": true
    },
    "validity": {
      "days": 123,
      "display": "<string>"
    },
    "price": {
      "amount": 123,
      "currency": "<string>"
    },
    "features": {
      "hasVoice": true,
      "hasSms": true,
      "voiceMinutes": 123,
      "smsCount": 123,
      "planType": "data"
    },
    "operator": {
      "name": "<string>",
      "imageUrl": "<string>",
      "apnType": "<string>",
      "apnValue": "<string>"
    },
    "coverage": [
      {
        "countryCode": "<string>",
        "countryName": "<string>",
        "networks": [
          {
            "name": "<string>",
            "types": [
              "<string>"
            ]
          }
        ]
      }
    ],
    "shortInfo": "<string>"
  },
  "meta": {
    "requestId": "req_abc123def456",
    "timestamp": "2023-11-07T05:31:56Z"
  }
}

Overview

Retrieve detailed information about a specific eSIM package, including destination, data allowance, validity, pricing, and network coverage.

Path Parameters

ParameterTypeDescription
packageIdstringPackage identifier from the packages list

Response Fields

The response includes comprehensive package details:

Package Info

FieldDescription
packageIdUnique identifier
nameDisplay name
tierPackage tier (standard/premium/unlimited)

Destination

FieldDescription
destination.slugDestination slug
destination.nameCountry/region name
destination.countryCodeISO country code
destination.typelocal/regional/global

Data & Validity

FieldDescription
data.amountData in MB
data.displayHuman-readable (e.g., “5 GB”)
data.isUnlimitedTrue for unlimited packages
validity.daysValidity period

Features

FieldDescription
features.hasVoiceIncludes voice minutes
features.hasSmsIncludes SMS
features.voiceMinutesMinutes included
features.smsCountSMS count
features.planTypedata-only or data-voice-text

Operator & Coverage

FieldDescription
operator.nameNetwork operator
operator.apnTypeAPN type (automatic/manual)
operator.apnValueAPN value if manual
coverageArray of covered countries with networks

Example Response

{
  "packageId": "merhaba-7days-5gb",
  "name": "Merhaba 7 Days 5GB",
  "tier": "standard",
  "destination": {
    "slug": "turkey",
    "name": "Turkey",
    "countryCode": "TR",
    "type": "local",
    "imageUrl": "https://cdn.fyatu.com/flags/tr.svg"
  },
  "data": {
    "amount": 5120,
    "display": "5 GB",
    "isUnlimited": false
  },
  "validity": {
    "days": 7,
    "display": "7 days"
  },
  "price": {
    "amount": 8.00,
    "currency": "USD"
  },
  "features": {
    "hasVoice": false,
    "hasSms": false,
    "voiceMinutes": null,
    "smsCount": null,
    "planType": "data-only"
  },
  "operator": {
    "name": "Turkcell",
    "imageUrl": "https://cdn.fyatu.com/operators/turkcell.png",
    "apnType": "automatic",
    "apnValue": null
  },
  "coverage": [
    {
      "countryCode": "TR",
      "countryName": "Turkey",
      "networks": ["Turkcell 4G", "Turkcell LTE"]
    }
  ],
  "shortInfo": "High-speed 4G/LTE data across Turkey"
}

Example Usage

const packageId = 'merhaba-7days-5gb';

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

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

// Display package details
console.log(`Package: ${data.name}`);
console.log(`Destination: ${data.destination.name}`);
console.log(`Data: ${data.data.display}`);
console.log(`Validity: ${data.validity.days} days`);
console.log(`Price: $${data.price.amount}`);

// Check features
if (data.features.hasVoice) {
  console.log(`Voice: ${data.features.voiceMinutes} minutes`);
}

// Show coverage for regional/global
data.coverage.forEach(c => {
  console.log(`${c.countryName}: ${c.networks.join(', ')}`);
});

Authorizations

Authorization
string
header
required

JWT access token obtained from /auth/token

Path Parameters

packageId
string
required

Package ID

Response

Package details retrieved successfully

success
boolean
Example:

true

status
integer
Example:

200

message
string
data
object
meta
object