Order a number

Developing

PUT

https://api-x.smsonline.cloud/v3/numbers/{userId}/order

Purchase a telephone number by specifying the country, service and carrier.

Request

Path Params

Body Params application/json

Example

{
    "apiKey":"",
    "country":"",
    "service":"",
    "carrier":"",
    "maximumPrice":"",
    "m":"",
    "n":""
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api-x.smsonline.cloud/v3/numbers//order' \
--header 'Content-Type: application/json' \
--data-raw '{
    "apiKey":"",
    "country":"",
    "service":"",
    "carrier":"",
    "maximumPrice":"",
    "m":"",
    "n":""
}'

Responses

🟢200Success

application/json

Body

Example

{
    "ok": true,
    "body": {
        "orderId": "1",
        "phoneNumber": "86123456789",
        "expiredAtUTC": "2025-05-17 06:07:13",
        "purchasePrice": 16
    }
}

🟢222Additional action required

Modified at 2025-06-10 13:35:38

Get inventory

Get order data