Get Order Status

Check the current status of an order and retrieve the activation code once available.

GET https://api2.sms4sats.com/orderstatus

Returns the current status of a receive or send order. For receive orders, the activation code and phone number appear in the response once the SMS has been delivered.

Query Parameters

Name	Type	Required	Description
orderId	String	Yes	Order ID returned by /createorder or /createsendorder.

200: OK — Receive Order (code received)

{
    status: 'OK', 
    paid: true, 
    code: 48010,
    id: 1125699791,
    number: 12345678901,
    timestamp: 1666613406969,
    country: 'India',
    service: 'openAI',
}

200: OK — Send Order

200: OK — No Number Available

500: Internal Server Error

Response Fields

Field	Type	Description
status	String	OK on success
paid	Boolean	Whether the Lightning invoice has been paid
code	Number	The SMS activation code (receive orders only — appears when delivered)
number	Number	The phone number assigned to this order
id	Number/String	Internal activation ID (receive) or SMS provider ID (send)
smsStatus	String	Send order status: created, sent, delivered, or failed
country	String	Country name
service	String	Service name
timestamp	Number	Unix timestamp (milliseconds)
error	String	Error message if a number could not be assigned

Polling

Poll this endpoint every few seconds after paying the invoice. The code field will appear once an SMS has been received. Most codes arrive within 30–120 seconds.

If paid is true but code is absent and more than 2 minutes have passed, consider calling Cancel Order to free the number and get your funds back.