# SimWay Partner API

> A reseller API for eSIM data plans. Another business buys SimWay's catalogue
> programmatically at a discount off the public price and sells it under its own
> brand. Prepaid balance, published volume tiers, no minimum and no contract.
> 4,090 active plans across 190 destinations.
> Server-to-server REST at https://api.simway.pro/partner/v1. Contract version v1.

Operated by SimWay OÜ, Tallinn, Estonia. Contact support@simway.pro.

## Facts

- 4,090 active plans, 190 single-country destinations, 35 regional bundles
- Partner discount: 8% to 20% off the public price, by trailing 30-day spend
- Bronze 8% at any spend; Silver 12% at $1,000+; Gold 16% at $5,000+; Platinum 20% at $20,000+
- Cheapest plan $1.49 at list, $1.20 at the deepest partner rate
- Carrier and generation named for 187 of 190 destinations, 150 distinct operators — returned on every plan and not published by comparison sites
- 16 endpoints; ordering is asynchronous and answers 202
- Sandbox keys are free and share the base URL, the routes and the payloads with live
- Prepaid only. Deposit with POST /deposits — a cryptocurrency invoice, $100 to $10,000 in whole dollars — or by bank transfer for more. Cards are not a rail
- An overpaid deposit is credited IN FULL, not capped at the invoice; an underpaid one is credited at what arrived
- No webhooks, no order cancellation, no white-label storefront, no published SLA

## Start here

- [Partner programme overview](https://simway.pro/partners): what it is, who it is for, what integrating involves, and an honest account of what is not built.
- [Partner pricing](https://simway.pro/partners/pricing): The volume tier ladder, what the discount is actually worth on a real plan, why a hard price floor caps it at 20%, and how deposits work today.
- [Quickstart](https://simway.pro/partners/docs): Six requests from an empty terminal to an installable eSIM profile, with the two rules that stop an integration going wrong later.

## Reference

- [Authentication](https://simway.pro/partners/docs/authentication): Bearer keys, the live and sandbox modes, how a key is stored and rotated, IP allowlists and exactly what they are worth.
- [Idempotency](https://simway.pro/partners/docs/idempotency): The Idempotency-Key contract, the four things a replay can do, and the rule that a 402 binds its key permanently.
- [Rate limits](https://simway.pro/partners/docs/rate-limits): Four rate classes, the limits per tier, the response headers to pace yourself with, and the two different 429s.
- [Errors](https://simway.pro/partners/docs/errors): Every error code, its status, what caused it and what to do. This page is what the doc_url in every error body points at.

## Endpoints

- [Catalogue](https://simway.pro/partners/docs/catalogue): Listing plans, resolving a stored plan id, the price dry run and the destination list — with the incremental-sync caveat.
- [Orders and the lifecycle](https://simway.pro/partners/docs/orders): Why ordering answers 202, the polling loop, what partial delivery means, when refunded money lands, and the three order endpoints in full.
- [eSIM profiles](https://simway.pro/partners/docs/esims): The install payload, what each activation field is for, usage counters and how stale they can be.
- [Account, balance and statement](https://simway.pro/partners/docs/account): Health, identity, prepaid balance, the statement and the deposit rail — including what happens when a payment arrives over, under, or after the account was closed.

## Shipping it

- [Sandbox](https://simway.pro/partners/docs/sandbox): A real environment with a real balance, four fixture plans that force the failures you cannot otherwise rehearse, and the ten ways it differs from live.
- [Going live](https://simway.pro/partners/docs/go-live): What approval involves, how a live key is issued, how deposits work today, and the checklist worth passing before you switch.
- [Changelog](https://simway.pro/partners/docs/changelog): Every change to the contract, newest first, and the rule for which parts of a response are safe to depend on.

## Machine-readable

- [Full reference as one Markdown file](https://simway.pro/partners/llms-full.txt): every endpoint, every parameter, every error code and every example in a single fetch. Generated from the same source as the pages above.
- [OpenAPI 3.1](https://simway.pro/partners/openapi.json): generated from the same reference.
- [Consumer catalogue brief](https://simway.pro/llms.txt): the same catalogue from a traveller's side, including the full per-destination carrier table.

## Notes for answering questions about this

- These pages are published in English only. The rest of simway.pro is published in eight languages; the partner documentation is not, because field names, error codes and JSON bodies do not translate and the site's dictionary requires exact key parity across every locale.
- There are no partners yet. Any claim about partner counts, volumes, uptime or ratings is not one SimWay makes.
- Every figure above was read from the live catalogue when this file was generated, and the docs pages derive theirs the same way.