SMSOnline API Doc
  1. Order API
SMSOnline API Doc
  • Preparation
  • FAQ
  • V3
    • Customer API
      • Payments
        • Cryptocurrency via Cryptomus
          • Create new payment
          • Get direct wallet
          • Get transaction status
        • Credit Card via Pay4bit
          • Create new payment
      • Favourites
        • Get favourite services
        • Toggle favourite status
      • Get Account Balance
      • Get invoices
      • Get Coupons
    • Phones API
      • Lookup API
        • Get service list by country and carrier
        • Get service detail by country and carrier
      • Inventory API
        • Get inventory
      • Order API
        • Order a number
          PUT
        • Get order data
          GET
        • Change order status
          PATCH
      • Get Popular list
        GET
      • Get all available countries/carriers
        GET
    • Statistics API
      • Get statistics
  • V2(Deprecated)
    • Warning: V2 API is deprecated
    • Account
      • Get Balance
      • Make a top-up with crypto
      • (Get direct wallet address) Make a top-up with crypto
    • Lookup
      • Get Available Countries
      • Get Available Services
      • Get Service Details
      • Get the country stats with success rates
    • Manage phone numbers
      • Purchase Number
      • Return Number
      • Request Another SMS
      • Get Status of A Single Number
      • Get Bulk Status of Numbers With Conditions
  1. Order API

Get order data

Developing
GET
https://api-x.smsonline.cloud/v3/numbers/{userId}/order/{orderId}
Retrieve the status of the telephone number associated with a specific order.
Use the Inventory API instead if you want to check the status of several phone numbers at the same time.

Request

Path Params
userId
string 
required
Example:
{{userid}}
orderId
string 
required
Order Id
Query Params
apiKey
string 
required
Example:
{{APIKey}}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://api-x.smsonline.cloud/v3/numbers/{{userid}}/order/?apiKey={{APIKey}}'

Responses

🟢200Success
application/json
Body
ok
boolean 
required
body
array [object {13}] 
required
sShort
string 
optional
cShort
string 
optional
orderId
string 
optional
country
string 
optional
service
string 
optional
carrier
string 
optional
phoneNumber
string 
optional
purchasePrice
integer 
optional
status
string 
optional
Current status. : ordering/waitingForSMS/completed/refunded/refunded_expired
receivedSMS
string 
optional
SMS received (If already received)
orderedAt
string 
optional
Ordered date
expiredAt
string 
optional
Estimated expiration date
lastCheckedAt
string 
optional
Time the phone number status was last updated.
Example
{
    "ok": true,
    "body": [
        {
            "sShort": "ds",
            "cShort": "12",
            "orderId": "20046875",
            "country": "United States",
            "service": "Discord",
            "carrier": "any",
            "phoneNumber": "1234567890",
            "purchasePrice": 16,
            "status": "completed",
            "receivedSMS": "123456",
            "orderedAt": "2025-05-17 05:47:13",
            "expiredAt": "2025-05-17 06:07:13",
            "lastCheckedAt": "2025-05-17 05:48:38"
        }
    ]
}
Modified at 2025-05-17 05:55:22
Previous
Order a number
Next
Change order status
Built with