Orders

Create an order

POST /orders accepts plan_id, quantity (1–20, default 1), optional days for daily plans, and a reference. Store order_id and each returned iccid.

curl -X POST "https://www.titansim.com/api/v1/orders" \
  -H "Authorization: Bearer tsk_test_<48 hex characters>" \
  -H 'Content-Type: application/json' \
  -d '{"plan_id":"YOUR_PLAN_ID","quantity":1,"reference":"your-order-123"}'

References and retries

The reference is unique per partner and makes order creation idempotent. Retry a timeout with the same reference and payload. A completed replay returns the original response with Idempotent-Replay: true. A changed payload returns 422; a request still in progress returns 409.

• GET /orders/{order_id} reads one order.
• GET /orders?reference=... finds an order by reference.
• GET /orders?cursor=... lists newest first.