Orders API

• One read-only endpoint lists the orders credited to your partner account and the commission on each, so you can reconcile them with your own records.
• Records are anonymous. They never contain the buyer’s name, email, account or customer ID, click ID, IP address, location, device or eSIM details.
• The same fields are in the CSV file from Export CSV in the partner dashboard (Earnings for creators, Orders for comparison sites; UTF-8 with a byte order mark, so Excel and Numbers open it as is).
• Price-comparison sites read the plan list with the same key: see the plan feed reference.

• The owner of an approved partner account creates keys in the dashboard under API keys, gives each a name, and can revoke them there. Up to 5 keys can be active at a time.
• The key is shown once, when it’s created. We only keep a hash of it, so a lost key can’t be shown again: revoke it and create a new one.
• Send it on every request, as x-api-key: <key> (the header the plan feed uses) or Authorization: Bearer <key>. A missing, wrong or revoked key gets 401 with missing_key, invalid_key or revoked, the same codes as the feed.
• Every key reads both your orders and the plan feed; there is nothing to choose when you create it.
• Keep keys on your server. Don’t put them in browser or app code.

x-api-key: svp_your_key

GET https://partners.simvito.com/api/simvito/partner-api/v1/orders

All parameters are optional query parameters.

Records come newest first. Read pages while has_more is true; on the last page next_cursor is null.

Every record has exactly these fields. Amounts are decimal strings.

Statuses change as orders move through the pending period and payouts or statements, and a refund after payout adds a refund record. To keep a copy in step, ask once a day for updated_since the time of your last sync (a few minutes earlier, to be safe) and upsert by order_id and type: that catches new orders, confirmations, reversals and payments, however old the order is. To check a statement before you invoice it, read it whole with statement=.

• 60 requests per minute per key. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (Unix seconds).
• Over the limit you get 429 with Retry-After in seconds.

{ "error": { "code": "revoked", "message": "This API key was revoked. Create a new one on your partner dashboard under Settings → API." } }

curl -s "https://partners.simvito.com/api/simvito/partner-api/v1/orders?from=2026-10-01&to=2026-10-31&limit=2" \
  -H "x-api-key: $SIMVITO_API_KEY"

{
  "data": [
    {
      "order_id": "order_sv_5ecbbdb71c217c023c953918920d88b7",
      "type": "sale",
      "ordered_at": "2026-10-21T09:06:41.208Z",
      "created_at": "2026-10-21T09:14:03.512Z",
      "updated_at": "2026-10-21T09:14:03.512Z",
      "confirmed_at": "2026-10-21T09:06:41.208Z",
      "statement": "2026-10",
      "plan_name": "Japan · 15 GB · 7 days",
      "variant_id": "variant_01K8F3JAPAN15GB7D",
      "order_amount": "20.65",
      "order_currency": "USD",
      "paid_amount": "18.90",
      "paid_currency": "EUR",
      "fx_rate": "0.9152",
      "fx_rate_date": "2026-10-20",
      "commission_amount": "2.07",
      "reversed_commission_amount": null,
      "commission_currency": "USD",
      "status": "confirmed",
      "reversed_reason": null,
      "refund_review": false,
      "link_key": "yoursite",
      "sub_id": "top10-japan"
    },
    {
      "order_id": "order_sv_f06d3829d4c619f0945d67114d6669ea",
      "type": "refund",
      "ordered_at": null,
      "created_at": "2026-10-19T16:40:11.004Z",
      "updated_at": "2026-10-19T17:00:00.130Z",
      "confirmed_at": "2026-10-19T17:00:00.130Z",
      "statement": "2026-10",
      "plan_name": null,
      "variant_id": null,
      "order_amount": "-9.50",
      "order_currency": "USD",
      "paid_amount": null,
      "paid_currency": null,
      "fx_rate": null,
      "fx_rate_date": null,
      "commission_amount": "-0.95",
      "reversed_commission_amount": null,
      "commission_currency": "USD",
      "status": "confirmed",
      "reversed_reason": null,
      "refund_review": false,
      "link_key": "yoursite",
      "sub_id": null
    }
  ],
  "has_more": true,
  "next_cursor": "MTc2MDg5MjAxMTAwNDpjbV8xMjM0"
}

The next page:

curl -s "https://partners.simvito.com/api/simvito/partner-api/v1/orders?from=2026-10-01&to=2026-10-31&limit=2&cursor=MTc2MDg5MjAxMTAwNDpjbV8xMjM0" \
  -H "x-api-key: $SIMVITO_API_KEY"

Every record that changed since your last daily sync:

curl -s "https://partners.simvito.com/api/simvito/partner-api/v1/orders?updated_since=2026-10-27T23:55:00Z" \
  -H "x-api-key: $SIMVITO_API_KEY"

Why one order was or wasn’t credited to you. Needs a key with orders access; 30 requests per minute per key.

GET https://partners.simvito.com/api/simvito/partner-api/v1/attribution?order_id=order_sv_5ecbbdb71c217c023c953918920d88b7

• Pass order_id (a Simvito order ID or the order number the buyer has) or click_id, not both.
• data has up to 5 records: order_id, ordered_at, result (one of the codes in the Attribution rules), explanation (one sentence), rules_version, decided_at, your_touch, commission and, for credited orders of comparison sites, calculation (rate, order amount, minimum, whether the margin floor applied).
• It only ever describes your own referral. Another partner is never named, and nothing about the buyer is returned.
• 503 unavailable when the lookup can’t answer right now; retry after Retry-After seconds.

{
  "data": [
    {
      "order_id": "order_sv_5ecbbdb71c217c023c953918920d88b7",
      "ordered_at": "2026-10-21T09:14:03.512Z",
      "result": "CREDITED",
      "explanation": "Credited to you.",
      "rules_version": "2026-10-28.1",
      "decided_at": "2026-10-21T09:12:40.118Z",
      "your_touch": { "occurred_at": "2026-10-19T16:02:11.000Z", "channel": "web", "evidence": "link" },
      "commission": { "amount": "1.89", "currency": "USD", "status": "pending" },
      "calculation": { "basis": "sale", "rate_percent": 10, "order_amount": "18.90", "minimum": "1.00",
        "minimum_applied": false, "capped_by_margin_floor": false }
    }
  ]
}

• A landing from your link sets a first-party cookie on simvito.com whose value our server signs (code, time, referral record, random browser ID). Altered values are ignored.
• An order is credited to the latest valid referral within 30 days before its checkout was created; the result and the rules version are fixed then.
• Paid orders are reported once per order ID (repeats count once), and every day we reconcile credited orders against commissions in both directions.
• The full rules, results and how to appeal: Attribution rules.

We email partners with API keys before a change that could break an integration. Additions that don’t (a new field, a new parameter) are listed here.

Email partners@simvito.com with the partner account’s email address. Never send your API key.