eSIM Tunisia — 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 esimtunisia.co.uk/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://esimtunisia.co.uk

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": "Tunisia 10GB / 30 days",
  "validity": 30,
  "dataCap": 10,
  "dataUnit": "GB",
  "prices": { "GBP": 14.99 },
  "coverages": [{ "code": "TN", "networks": [] }],
  "telephony": null,
  "tethering": true,
  "eKYC": false,
  "canTopUp": false,
  "subscription": false,
  "promoEnabled": true,
  "link": "https://esimtunisia.co.uk/r/MYBESTSIM?plan=tn-10gb-30d",
  "additionalInfo": "Validity starts when the eSIM first connects to a Tunisian 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)
`coverages[].networks`	Carrier names, listed only once confirmed from a provisioned profile — an empty list means "major local networks", not "none"
`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. Cache: 1 hour.

[{ "name": "Tunisia eSIM plans", "link": "https://esimtunisia.co.uk/r/MYBESTSIM", "type": "web", "targets": ["TN"] }]

3. Tracking links

Link	Behaviour
`https://esimtunisia.co.uk/r/{CODE}`	Sets the 30-day attribution cookie, lands on the plan list
`https://esimtunisia.co.uk/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

Dashboard — a private tokenised URL (shared during onboarding) showing every attributed sale in real time: plan, net value, commission, monthly totals. Read-only, no customer PII.
Monthly statement — emailed on the 1st of each month covering the previous month, with per-order detail and the commission total due.

5. Assets

Logo (PNG, 512×512): https://esimtunisia.co.uk/brand/tn/icon-512.png
Logo (SVG): https://esimtunisia.co.uk/brand/tn/logo.svg
From-price, plan range, FAQs: https://esimtunisia.co.uk/llms.txt (machine-readable summary kept current automatically)

Questions: hello@esimtunisia.co.uk.