GET/v1/sms/orders/:id

Get an order

Returns a single SMS order, including otp_code once a code has arrived.

Required scope: orders.readRate limit: 10 rps

Parameters

idstringrequired

The order ID.

Code samples

curl -X GET "https://samaprime.com/api/v1/sms/orders/smsord_01J8X9AABBCCDD" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json"

Response

→ 200
{
  "data": {
    "id": "ord_01J8X9AABBCCDD",
    "status": "received",
    "phone_number": "+15551234567",
    "otp_code": "482913",
    "cost_usd": "0.8000",
    "expires_at": "2026-08-10T15:02:00Z",
    "created_at": "2026-08-10T14:52:00Z",
    "service": "whatsapp",
    "country": "us"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-08-06T12:00:00Z"
  }
}

Errors

Status	Code
404	`not_found` No order with this ID belongs to this user.