> For the complete documentation index, see [llms.txt](https://docs.sms4sats.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sms4sats.com/api-reference/get-order.md).

# Poll an Order

Poll a protected receive-SMS or rental order and read its messages and cancellation state.

{% tabs %}
{% tab title="Receive SMS" %} <mark style="color:blue;">`GET`</mark> `/v2/receive-sms/orders/{orderId}`
{% endtab %}

{% tab title="Rent Number" %} <mark style="color:blue;">`GET`</mark> `/v2/rent-numbers/orders/{orderId}`
{% endtab %}
{% endtabs %}

```http
Authorization: Bearer <accessToken>
```

```bash
curl -sS https://api.sms4sats.com/v2/receive-sms/orders/ORDER_ID \
  -H 'Authorization: Bearer ACCESS_TOKEN'
```

## Representative response

```json
{
  "id": "<payment-hash>",
  "orderId": "<payment-hash>",
  "type": "receive-sms",
  "country": "151",
  "service": "tg",
  "status": "waiting_for_sms",
  "orderStatus": "waiting_for_sms",
  "priceSats": 350,
  "phoneNumber": "+1...",
  "messages": [],
  "durationMinutes": null,
  "createdAt": "2026-09-30T19:00:00.000Z",
  "updatedAt": "2026-09-30T19:01:10.000Z",
  "paidAt": "2026-09-30T19:01:00.000Z",
  "expiresAt": "2026-09-30T19:21:00.000Z",
  "completedAt": null,
  "cancelledAt": null,
  "failedAt": null,
  "cancellation": {
    "eligible": false,
    "availableAt": "2026-09-30T19:04:00.000Z"
  }
}
```

A delivered message appears as:

```json
{
  "id": "<message-id>",
  "code": "123456",
  "content": "Your verification code is 123456",
  "receivedAt": "2026-09-30T19:02:00.000Z"
}
```

## Polling rules

* Poll every **5–10 seconds**.
* Treat `status` and `orderStatus` as equivalent lifecycle fields.
* Do not infer success from the presence of a phone number; wait for a message and terminal state.
* Stop on `completed`, `cancelled`, `expired`, or `failed`.
* Keep polling transitional states rather than creating a replacement order.

See [Order States](/api-reference/order-states.md) for the complete state machine.