Build with eSIM Park

Who we work with

Pick the model that fits you. If none does, apply anyway and tell us what you have in mind.

Plans API overview

A read-only REST endpoint that returns one JSON document: every plan that can be bought online on esimpark.com, with the same prices the product page shows and the checkout charges.

Base URL

https://uj684erdvk.execute-api.eu-central-1.amazonaws.com/v1

Format

JSON (UTF-8), gzip on request

Authentication

x-api-key header, one key per partner

Prices

final consumer prices including VAT, in USD, EUR, GBP, PLN, RON, HUF

Updates

the document is rebuilt with every release; polling once a day is enough

Machine-readable spec

OpenAPI 3.1 (YAML) · JSON Schema

Authentication

Every request needs your API key in the x-api-key header. Keys are issued per partner after we review your application — apply below or write to partner@esimpark.com.

• Keep the key on your server. The API sends no CORS headers, so calls from a browser will fail — and a key in front-end code would be public.
• If a key leaks, tell us: we disable it and issue a new one.
• A missing, wrong or disabled key gets 403.

Endpoints

Two GET endpoints. There are no query parameters: one response contains every plan in every currency.

Example request

curl --compressed \
  -H "x-api-key: $ESIMPARK_API_KEY" \
  -H 'If-None-Match: "<last ETag>"' \
  https://uj684erdvk.execute-api.eu-central-1.amazonaws.com/v1/plans

Example response (shortened: one destination, two of its plans)

{
  "apiVersion": 1,
  "updatedAt": "2026-10-27T10:50:12Z",
  "dataVersion": "92291e58d693d2be",
  "schema": "/v1/schema",
  "provider": {
    "name": "eSIM Park",
    "website": "https://www.esimpark.com/",
    "contact": "partner@esimpark.com"
  },
  "currencies": [
    "USD",
    "EUR",
    "GBP",
    "PLN",
    "RON",
    "HUF"
  ],
  "pricesIncludeVat": true,
  "esimFee": {
    "amount": {
      "USD": 1.63,
      "EUR": 1.36,
      "GBP": 1.23,
      "PLN": 6.19,
      "RON": 7.42,
      "HUF": 490
    },
    "appliesTo": "Purchases that need a new eSIM profile (normally the first purchase). Top-ups onto an eSIM Park eSIM the traveller already has are exempt.",
    "waived": {
      "from": "2026-09-16T00:00:00+02:00",
      "until": "2027-01-01T00:00:00+01:00"
    }
  },
  "planTerms": {
    "validityStarts": "first connection to a supported network at the destination",
    "delivery": "QR code by e-mail right after payment",
    "hotspot": true,
    "topUps": true,
    "refund": "full refund within 15 days if the eSIM was not installed and no data was used"
  },
  "linkParameters": {
    "cur": "ISO currency code to open the page in, e.g. ?cur=EUR",
    "ref": "partner code for attribution, e.g. ?ref=CODE (ask us for one)",
    "utm_*": "utm_source / utm_medium / utm_campaign / utm_content are recorded"
  },
  "destinations": [
    {
      "id": "torokorszag",
      "name": "Turkey",
      "type": "country",
      "countries": [
        {
          "iso2": "TR",
          "name": "Turkey",
          "networks": [
            "Turk Telekom Turkey",
            "Vodafone Turkey"
          ]
        }
      ],
      "url": "https://www.esimpark.com/esim-turkey.html",
      "localizedUrls": {
        "en": "https://www.esimpark.com/esim-turkey.html",
        "pl": "https://www.esimpark.com/pl/esim-turcja.html"
      }
    }
  ],
  "plans": [
    {
      "id": "torokorszag-m-5gb-15d",
      "destinationId": "torokorszag",
      "name": "Turkey 5 GB / 15 days",
      "countries": [
        "TR"
      ],
      "dataType": "fixed",
      "dataGb": 5,
      "dailyDataGb": null,
      "validityDays": 15,
      "throttling": null,
      "prices": {
        "USD": 5.9,
        "EUR": 4.9,
        "GBP": 4.9,
        "PLN": 22.9,
        "RON": 27.9,
        "HUF": 1790
      },
      "url": "https://www.esimpark.com/esim-turkey.html"
    },
    {
      "id": "torokorszag-xl-3gbday-5d",
      "destinationId": "torokorszag",
      "name": "Turkey 3 GB/day / 5 days",
      "countries": [
        "TR"
      ],
      "dataType": "daily",
      "dataGb": null,
      "dailyDataGb": 3,
      "validityDays": 5,
      "throttling": {
        "afterPercentOfDailyData": 80,
        "speedKbps": 128,
        "dailyDataCarriesOver": false
      },
      "prices": {
        "USD": 13.9,
        "EUR": 11.9,
        "GBP": 9.9,
        "PLN": 50.9,
        "RON": 60.9,
        "HUF": 3990
      },
      "url": "https://www.esimpark.com/esim-turkey.html"
    }
  ]
}

The values come from the live document at the time this page was built.

Response fields

New optional fields may appear at any time — ignore the ones you don't know. Amounts are in major units (22.9 = 22.90); HUF has no decimals.

Top level

destinations[]

plans[]

Errors & rate limits

Limits apply per key: 5 requests per second (short bursts up to 10) and 1 000 requests per day. The daily count resets at 00:00 UTC. Error bodies are JSON: {"message": "…"}.

Caching & polling

• Responses carry ETag, Last-Modified and Cache-Control: private, max-age=3600.
• Send the last ETag back in If-None-Match: if nothing changed you get 304 with no body.
• Once a day is plenty. Prices change only when we reprice, and dataVersion tells you whether anything moved.

Versioning & deprecation

• The version is in the path: /v1/.
• Adding optional fields is not a breaking change and can happen at any time — ignore fields you don't know.
• Removing or renaming a field, or changing its type or meaning, only happens in a new version (/v2/).
• Before a version stops working we e-mail every key holder and note it in the changelog at least 90 days in advance.

Changelog

• 2026-10-22v1 released: GET /v1/plans and GET /v1/schema, API keys with per-partner limits, JSON Schema and OpenAPI 3.1 file.

Terms of use

By using a key you agree to the following:

• Show the final price including VAT exactly as delivered, and the one-time eSIM fee wherever it applies (it is waived between esimFee.waived.from and until).
• Link to our product page for the purchase (url or localizedUrls), with your own utm or partner parameter.
• Don't resell, redistribute or pass the data on to third parties, and don't use it to train or feed other price databases.
• Refresh at least once a day. The price at our checkout is the one that applies.
• Keep your key secret. We may disable keys that break these terms or the limits, and we tell you why.
• The data is provided as-is, without warranty. We offer no SLA.

Apply for access

Tell us who you are and how you'd use the data. We usually reply within two working days from partner@esimpark.com.

Support & contact

• Questions about keys, fields or a partnership: partner@esimpark.com.
• We don't offer an SLA, a status page or a sandbox. The API is read-only, so you can safely develop against the production endpoint.
• Missing a field or need a different shape? Tell us — we add what partners need.