Request format
Content-Type: application/json- The three signature headers on every call; see Authentication
- A timestamp within 5 minutes of our clock
Response format
JSON with snake_case keys. Timestamps are ISO 8601 in UTC (2026-11-16T03:00:00Z); calendar dates are YYYY-MM-DD.
Ignore keys you do not recognise. We add fields without notice and record them
in the changelog; we do not remove or rename one without notice.
Identifiers
external_order_id is 1 to 64 characters of letters, digits, - and _. It
only has to be unique among your own orders. It is also what makes ordering
safe to retry: see Retrying an order.
Errors
Every error is JSON, in one of three shapes depending on the status:5xx responses are not guaranteed to be JSON. Do not parse them; retry later.
A 422 caused by our eSIM provider carries a generic message,
eSIM provider request failed. Please retry later. For an order, retry with the
same external_order_id.
Each endpoint lists its own errors under its Errors section, for example
Create an order.
Rate limits
List products allows 10 requests per minute per access key; it returns the whole catalogue and is meant to be fetched daily. Going over returns429 with a Retry-After header in seconds and
{"errors": ["Too many requests. Please try again shortly."]}.