---
title: "Create Order"
method: POST
path: "/api/orders"
tags: ["orders"]
---

# Create Order

`POST /api/orders`

## Request

- Base URL: `https://esimker.com` (the document declares no server; this is the origin it was published from)
- URL: `https://esimker.com/api/orders`
- Auth: none declared

Create an unpaid order and its checkout. Open `checkout_url` to pay (card or
crypto, hosted by the gateway); the order page is `/order?t={token}`. 403 from
embargoed jurisdictions, 10 orders per minute per IP.

## Headers

- `X-Wallet-Code` string, nullable

## Request body

- CreateOrderIn
  - `plan_id` integer, required
  - `email` string, email, nullable
  - `topup_iccid` string, nullable
  - `promo_code` string, nullable
  - `referral_code` string, nullable
  - `gift` boolean
  - `lang` string, nullable
  - `payment_method` string
  - `payment_gateway` string, nullable
  - `period_num` integer, nullable
  - `client_ref` string, nullable

## Response `200`

Successful Response

- CreateOrderOut
  - `token` string, required
  - `checkout_url` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/esimker/apis/esimker-api.md) · [All operations](https://skmtc.dev/esimker/apis/esimker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/esimker/apis/esimker-api/revisions/13ea312e6990?raw)