Single order
POST/order/single
Places one order. The server waits up to 55 seconds for the result and returns it sooner if it is ready; set your client timeout above that, for example 70 seconds. If the lookup is still running, the response is a small processing envelope instead of the full order. A client timeout does not mean the order failed, so do not resubmit automatically. See Placing orders and polling.
Send the number in imei (a string). batchName is optional; if you send it, it cannot be an empty string, so leave the field out instead. Without it the order goes into a batch named "Direct order".
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 405
- 500
Single order placed successfully
Bad Request — TAC_FAILED, INVALID_IMEI_PROVIDED, SERVICE_ID_MUST_BE_NUMBER, BATCH_NAME_REQUIRED, IMEI_REQUIRED
Unauthorized — INVALID_TOKEN, YOUR_IP_IS_NOT_PERMITED
Forbidden — LOGIN_AGAIN, YOU_ARE_NOT_ALLOWED, YOU_ARE_BLOCKED, PENDING_FOR_APPROVAL, CREDIT_LIMIT_REACHED, LOW_CREDIT
Not Found — SERVICE_NOT_FOUND
Method Not Allowed — SERVICE_IS_DISABLED
Internal Server Error — unexpected server failure