Plan feed

1. In your partner dashboard, open API keys and create a key. It is shown once; keep it on your server.
2. Pull the feed. Replace YOUR_KEY with your key:

curl --compressed -H "x-api-key: YOUR_KEY" https://api.simvito.com/feeds/v1/plans -o plans.json

3. Show each record with its link as it is. The link opens checkout on simvito.com with that plan selected and carries your code (via=yourcode); an order from it is credited to you.
4. Optional: add &subid= with your own ID for the page or placement (letters, digits, . _ -, up to 64; nothing about the visitor). It comes back on the order as sub_id, next to variant_id (the link’s v=).

• Send your key in the x-api-key header, as in the eSIMDB Provider API. Authorization: Bearer svp_… is accepted too.
• Each site has its own keys. The dashboard shows when each key was last used, and a key can be revoked on its own. A revoked key stops working within 5 minutes.
• If our key service is briefly unreachable, keys keep working on their last check for up to 24 hours, so the feed stays up; a key revoked during such an outage can work until it ends.
• The same key reads your orders through the orders API.

GET https://api.simvito.com/feeds/v1/plans
x-api-key: svp_your_key

• A JSON array, one record per plan and validity period, in the eSIMDB Provider API DataPlan format plus two extension fields. A reader built for that format needs no new parser.
• About 33,500 records: about 55 MB with every currency, about 46 MB with USD only, under 5 MB with Accept-Encoding: gzip.
• The response has no customer data: only the catalog, prices and your own purchase links.
• Every response, errors included, carries x-request-id. Quote it when you write to us about a request.

A real record (a daily plan with the full fair-use fields), with your code in the link:

{
  "planName": "Japan 3GB/day for 7 Days (5G, 128 Kbps after cap)",
  "validity": 7,
  "dataCap": 3,
  "dataUnit": "GB",
  "prices": {
    "USD": 7.95,
    "EUR": 7.27,
    "GBP": 6.08,
    "HKD": 62.38,
    "CNY": 54.07,
    "SGD": 10.39,
    "JPY": 1280,
    "AUD": 11.53,
    "NZD": 14.22,
    "CAD": 11.37,
    "BRL": 43.36,
    "IDR": 147086,
    "MYR": 33.16,
    "PHP": 518.93,
    "THB": 273.84,
    "KRW": 10767,
    "PLN": 32.01,
    "CHF": 6.72,
    "SEK": 80.58,
    "TWD": 264
  },
  "coverages": [
    {
      "code": "JP",
      "networks": [
        {
          "name": "KDDI",
          "types": ["4G", "5G"]
        },
        {
          "name": "SoftBank",
          "types": ["4G", "5G"]
        }
      ]
    }
  ],
  "subscription": false,
  "promoEnabled": false,
  "telephony": null,
  "hasAds": false,
  "payAsYouGo": false,
  "newUserOnly": false,
  "link": "https://simvito.com/checkout/?s=japan&v=variant_01M2S8RTA4JXWNBMT0CNKZVS7G&d=7&via=yourcode&utm_source=yourcode&utm_medium=referral",
  "dataCapPer": "day",
  "reducedSpeed": 128,
  "capacityInfo": "Unlimited data at 128 Kbps after 3GB of high-speed data per day is used up.\nThe daily high-speed allowance resets at 00:00 (UTC+8).",
  "validityInfo": "Each day of validity is a full 24-hour period from the start of plan validity.\nActivate within 90 days of purchase.",
  "additionalInfo": "Validity starts when the eSIM first connects to a network at the destination.\nOn Android phones, TikTok doesn't work on this plan.",
  "canTopUp": false,
  "internetBreakouts": [
    { "country": "HK" },
    { "country": "SG" }
  ],
  "dailyReset": {
    "type": "calendar",
    "time": "00:00",
    "timezone": "UTC+8"
  }
}

A field that doesn’t apply is omitted, as in the eSIMDB format. Unknown values are never filled with a guess.

Two fields are additions to the eSIMDB DataPlan format; everything else keeps that format’s names, types and omission rules. A reader that ignores the two still reads every record; it only loses the difference between “stops at cap” and “not stated”, and the reset time, which capacityInfo also gives in words.

• exhaustionBehavior: "unknown" when it isn’t confirmed yet what happens after the allowance. capacityInfo says the same in words.
• dailyReset: when a daily allowance renews. Present on every daily plan (dataCapPer: "day").

The rest of the fair-use policy uses the standard fields: daily high-speed data is dataCap + dataUnit with dataCapPer: "day", the speed after the daily cap is reducedSpeed, and a speed cap from the start is maxSpeed.

• prices has one entry per currency a buyer can pay in by card at checkout (currently 20: USD, EUR, GBP, HKD, CNY, SGD, JPY, AUD, NZD, CAD, BRL, IDR, MYR, PHP, THB, KRW, PLN, CHF, SEK, TWD), unless your account receives USD only.
• Each amount is the final amount charged for a card payment in that currency, after rounding, with no fees added later. It matches the checkout page. Other payment methods cost the same or less.
• Prices are the same for every partner and for visitors who come to simvito.com directly.
• JPY, KRW, IDR and TWD are whole numbers.

• Every 200 carries an ETag. Send it back as If-None-Match (the weak form W/"…" works too) and you get 304 Not Modified with no body until the catalog, a price or an exchange rate changes.
• Right after a change, two requests a few seconds apart can for up to a minute alternate between the new and the previous version, each with its own ETag; the newer one wins on your next pull.
• Non-USD prices use our checkout exchange rates, which update once a day, so they can change while the USD price doesn’t. X-Rates-As-Of says which day’s rates the prices use; X-Currencies lists the currencies in prices.

ETAG=$(grep -i '^etag:' headers.txt | cut -d' ' -f2- | tr -d '\r')
curl -sS --compressed -H "x-api-key: YOUR_KEY" -H "If-None-Match: $ETAG" -D headers.txt -o plans.json https://api.simvito.com/feeds/v1/plans

• Once an hour is right, with If-None-Match: you pick up new rates the same day. Don’t pull more than once a minute.
• Each IP address can make about 30 requests a minute; above that you get 429 with Retry-After in seconds.

Errors are JSON: { "error": { "code": "…", "message": "…" } }. Your dashboard’s Integration status page lists your recent errors with their request IDs.

Buttons to our destination pages, such as “Japan eSIM plans”, in the eSIMDB Provider API DestinationLink format, if you’d like to show them on your own destination pages. The plans themselves are in the plan feed; this list has no prices.

GET https://api.simvito.com/feeds/v1/destination-links
x-api-key: YOUR_KEY

• The same key, errors, x-request-id, ETag / 304 and rate limit as the plan feed (the per-address limit is shared between the two).
• One record per destination page and language, about 900 in all. It changes only when we add or retire a destination: once a day with If-None-Match is plenty.
• name (≤ 30 characters) is in the page’s language. link already carries your referral, like the plan links. targetLanguages: our English pages are listed for en, fr and es (we have no French or Spanish pages), Japanese pages for ja, Italian pages for it. targets are ISO 3166-1 alpha-2 codes: the country of a single-country page, every covered country of a multi-country one; no region slugs.

[
  {
    "name": "Japan eSIM plans",
    "link": "https://simvito.com/esim/japan/?via=yourcode&utm_source=yourcode&utm_medium=referral",
    "type": "web",
    "targetLanguages": ["en", "fr", "es"],
    "targets": ["JP"]
  },
  {
    "name": "日本のeSIMプラン",
    "link": "https://simvito.com/ja/esim/japan/?via=yourcode&utm_source=yourcode&utm_medium=referral",
    "type": "web",
    "targetLanguages": ["ja"],
    "targets": ["JP"]
  }
]

• A visit through a record’s link is recorded on our server; an order within 30 days is credited to the latest valid referral. The full rules: Attribution rules.
• Your orders and commission are in the dashboard under Orders, and in the orders API.

The version is in the path (/feeds/v1). Changes are listed here with their date.

Email partners@simvito.com with your partner account’s email address and, for a request, its x-request-id. Never send your API key.