eSIM Florida — Partner API

Public, read-only JSON endpoints for comparison-site partners. No API key is needed; everything is keyed by your partner slug (in your welcome email — e.g. mybestsim; self-serve partners get one automatically at esimflorida.com/partners). Attribution runs on your exclusive promo code plus a 30-day first-party cookie, so listings, deep links and code-only sales (AI assistants, social) all credit to you.

Base URL: https://esimflorida.com

1. Plan feed

GET /partners/{partner}/data-plans

Returns every live plan as a JSON array, priced exactly as at checkout (GBP; card networks handle currency conversion for overseas buyers). Cache: 10 minutes (Cache-Control: public, max-age=600). Poll as often as you like — hourly is plenty; prices change rarely.

Example element:

{
  "planName": "US 15GB / 30 days",
  "validity": 30,
  "dataCap": 15,
  "dataUnit": "GB",
  "prices": { "GBP": 16.99 },
  "coverages": [{ "code": "US", "networks": [
    { "name": "AT&T", "types": ["4G", "5G"] },
    { "name": "Verizon", "types": ["4G", "5G"] }
  ]}],
  "telephony": null,
  "tethering": true,
  "eKYC": false,
  "canTopUp": false,
  "subscription": false,
  "promoEnabled": true,
  "link": "https://esimflorida.com/r/MYBESTSIM?plan=us-15gb-30d",
  "additionalInfo": "Validity starts when the eSIM first connects to a US network. Install up to 6 months ahead."
}

Field notes:

Field Meaning
planName Display name (max 100 chars)
validity Days the plan runs once activated
dataCap / dataUnit Total data; dataUnit is GB or MB
dataCapPer Present only on daily plans ("day" = cap resets daily)
prices Live checkout price, keyed by currency (GBP)
telephony Always null — plans are data-only
promoEnabled true when your promo code applies to the plan
link Ready-made tracking deep link — use as-is

2. Destination links

GET /partners/{partner}/destination-links

One entry per destination we cover (currently the USA). Cache: 1 hour.

[{ "name": "USA eSIM plans", "link": "https://esimflorida.com/r/MYBESTSIM", "type": "web", "targets": ["US"] }]

3. Tracking links

Link Behaviour
https://esimflorida.com/r/{CODE} Sets the 30-day attribution cookie, lands on the plan list
https://esimflorida.com/r/{CODE}?plan={sku} Same, but lands directly on that plan's checkout page

{CODE} is your exclusive promo code (also the attribution key). The code is auto-applied at checkout after following either link — the customer sees the discounted price without typing anything. The code is case-insensitive when typed manually.

Attribution rules: a sale credits to you when your code was applied at checkout or your cookie was present when the order was placed — whichever happens, including customers who arrive without referrer data and just type the code. Cookie window: 30 days, last-click.

4. Reporting

5. Assets