Esoim Data Plans & Partner API

Welcome to the official Esoim Public Partner API. This programmatic catalog feed provides automated, sub-millisecond access to our complete global inventory of prepaid travel eSIM packages across 200+ countries and regional bundles.

Comparison Portals & eSIMDB Standards

Our data plan feeds strictly comply with the official eSIMDB Provider Data Plans Specification (OpenAPI 3.0.3) and top telecom aggregator standards:

Access & Performance Headers

Our catalog feeds are public, read-only, and highly optimized. No API keys or authorization headers are required to fetch real-time packages.

Partner Attribution & 30-Day Tracking

To automatically attach your partner referral tracking code to every product checkout link in the feed, pass ?ref=YOUR_CODE to the API endpoint:

Returns the complete active catalog of international travel eSIM packages according to OpenAPI 3.0.3 standards.

Endpoint URLs

Query Parameters

Live Response Sample (HTTP 200 OK)

[
  {
    "planName": "Germany eSIM 5 GB (30 Days)",
    "validity": 30,
    "dataCap": 5,
    "dataUnit": "GB",
    "dataCapPer": null,
    "reducedSpeed": null,
    "prices": {
      "EUR": 4.99
    },
    "coverages": [
      "DE"
    ],
    "link": "https://esoim.com/esim/germany?plan=101&ref=esimdb",
    "telephony": null,
    "subscription": false,
    "tethering": true,
    "eKYC": false,
    "canTopUp": true,
    "promoEnabled": true,
    "additionalInfo": "Instant email delivery with QR code.\nHigh-speed 4G/5G mobile data.\nNo physical SIM card swap required."
  },
  {
    "planName": "Japan eSIM 2 GB (1 Days)",
    "validity": 1,
    "dataCap": 2,
    "dataUnit": "GB",
    "dataCapPer": null,
    "reducedSpeed": 512,
    "prices": {
      "EUR": 2.99
    },
    "coverages": [
      "JP"
    ],
    "link": "https://esoim.com/esim/japan?plan=1243&ref=esimdb",
    "telephony": null,
    "subscription": false,
    "tethering": true,
    "eKYC": false,
    "canTopUp": false,
    "promoEnabled": true,
    "additionalInfo": "Instant email delivery with QR code.\nHigh-speed 4G/5G mobile data.\nNo physical SIM card swap required."
  }
]

Returns destination-specific landing page links for all 176 individual country pages and 9 major regional bundles (Europe, Asia, North America, Global, etc.).

Live Response Sample (HTTP 200 OK)

[
  {
    "name": "United States plans",
    "link": "https://esoim.com/esim/united-states?ref=esimdb",
    "type": "web",
    "targets": [
      "US",
      "united-states"
    ]
  },
  {
    "name": "Europe plans",
    "link": "https://esoim.com/esim/AX-AT-BE?ref=esimdb",
    "type": "web",
    "targets": [
      "europe",
      "EU"
    ]
  }
]

Data Plan Schema Specification

Definition of each field provided within the product item objects:

Integration Code Examples

• cURL
• Python
• JavaScript / Node
• PHP

# Fetch live eSIM catalog
curl -X GET "https://esoim.com/esimdb/data-plans?ref=YOUR_PARTNER_CODE" \
     -H "Accept: application/json"

import requests

url = "https://esoim.com/esimdb/data-plans?ref=YOUR_PARTNER_CODE"
response = requests.get(url, headers={"Accept": "application/json"})
plans = response.json()

print(f"Total available plans: {len(plans)}")
for plan in plans[:5]:
    print(f"- {plan['planName']}: €{plan['prices']['EUR']} ({len(plan['coverages'])} countries)")

async function getEsimPlans() {
  const response = await fetch('https://esoim.com/esimdb/data-plans?ref=YOUR_PARTNER_CODE');
  const plans = await response.json();

  console.log(`Fetched ${plans.length} plans successfully`);
  console.log('Sample plan:', plans[0]);
}

getEsimPlans();

<?php
$json = file_get_contents('https://esoim.com/esimdb/data-plans?ref=YOUR_PARTNER_CODE');
$plans = json_decode($json, true);

echo "Total plans: " . count($plans) . "\n";
echo "First plan: " . $plans[0]['planName'] . " - €" . $plans[0]['prices']['EUR'] . "\n";
?>

Standard XML RSS 2.0 product catalog feed for Google Merchant Center and Google Shopping integration.