Skip to main content
Conventions that apply to every request.

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 returns 429 with a Retry-After header in seconds and {"errors": ["Too many requests. Please try again shortly."]}.
Last modified on November 17, 2026