Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: esimker Support API
description: 'Prepaid travel data eSIMs. No account is needed: an order is addressed by
the secret token from its URL. Prices are USD strings, from $1.00.
Two ways to buy:
- **Storefront flow** (`catalog`, `orders`): pick a plan, `POST /api/orders`, send the
buyer to `checkout_url` to pay in crypto, then poll `GET /api/orders/{token}`
until `status` is `ready` — the eSIM (`esim.activation_code`) is in the payload.
- **Prepaid wallet** (`wallet`): `POST /api/wallet` mints a wallet whose secret code is
the only credential (`X-Wallet-Code`); `POST /api/wallet/deposits` opens a top-up
invoice and, with `currency` set, returns the coin address and the exact amount for a
payer with no browser; `POST /api/orders` with `payment_method: "wallet"` charges the
balance and issues at once (`client_ref` makes a retry return the same order).
- **Reseller API** (`reseller`): white-label partners on `X-API-Key`, retail minus a
discount; keys are issued by support.
The wallet and the catalogue are also MCP tools at `POST https://esimker.com/api/mcp`
(Streamable HTTP; the wallet code goes in `Authorization: Bearer`).
The guide for agents is https://esimker.com/agents (the wallet: https://esimker.com/agents#wallet).
**Buyer accounts** (`account`) are the storefront''s own cabinet: an address and a password
as a second way for a person to reach their orders and wallets, on a session cookie with a
CSRF echo. An account is optional and nothing above needs one — an agent keeps the order
token and the wallet code, and has no use for these routes.'
version: '1'
tags:
- name: Support
paths:
/api/support/tickets:
post:
tags:
- Support
summary: Create Ticket
operationId: create_ticket_api_support_tickets_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/TicketIn'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/TicketOut'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
TicketIn:
properties:
email:
type: string
format: email
title: Email
message:
type: string
maxLength: 5000
title: Message
topic:
type: string
pattern: ^(order|esim|refund|other)$
title: Topic
default: other
order_ref:
type: string
maxLength: 255
title: Order Ref
default: ''
lang:
anyOf:
- type: string
pattern: ^[A-Za-z]{2}(-[A-Za-z]{4})?$
- type: 'null'
title: Lang
website:
type: string
maxLength: 255
title: Website
default: ''
type: object
required:
- email
- message
title: TicketIn
TicketOut:
properties:
key:
type: string
title: Key
type: object
required:
- key
title: TicketOut
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError