---
title: "Place an order, paid from your balance"
method: POST
path: "/orders"
---

# Place an order, paid from your balance

`POST /orders`

## Request

- Base URL: `https://slashtel.com/api/v1`
- URL: `https://slashtel.com/api/v1/orders`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `type` 'topup' | 'esim', required
  - `phone` string: Top-up: full international number, e.g. +911234567890
  - `operator_code` string: Top-up: optional, from /topup/quote
  - `sku` string: Top-up: sku from /topup/quote
  - `send_value` number: Top-up: send_value from /topup/quote
  - `plan_id` string: eSIM: plan_id from /esim/plans
  - `deliver_to_email` string: eSIM: optional; emails the QR code to your customer. Leave empty to deliver it yourself from the response.

## Response `200`

Completed or pending

- object
  - `success` boolean
  - `data` object
    - `id` string
    - `type` string
    - `status` 'completed' | 'pending' | 'failed'
    - `sandbox` boolean
    - `price_gbp` number
    - `result` object: Top-up: transfer_ref. eSIM: iccid, qr_code_url, lpa.
    - `error` string, nullable
  - `error` object, nullable
    - `code` string
    - `message` string
  - `meta` object

## Other responses

- `422`: Failed; nothing taken from balance

---

[API](https://skmtc.dev/slashtel/apis/slashtel-reseller-api.md) · [All operations](https://skmtc.dev/slashtel/apis/slashtel-reseller-api/llms.txt) · [OpenAPI document](https://skmtc.dev/slashtel/apis/slashtel-reseller-api/revisions/4f223d66edb6?raw)