DEVELOPER FIRST

API built for speed & reliability

Integrate virtual phone numbers and real-time SMS into your products with a predictable REST API.

POST/api/v1/numbers/buy200 OK

Fast activation99.9% uptimeWebSocket eventsScoped keys

Authentication

Send your API key as a Bearer token. Keys are hashed at rest and shown only once.

Authorization: Bearer YOUR_API_KEY

POST/api/v1/numbers/buyPurchase a temporary number

Request

curl -X POST https://api.getsimotp.com/api/v1/numbers/buy \
+  -H "Authorization: Bearer YOUR_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"country":"US","service":"telegram"}'

Response · 200 OK

{
  "order_id": "GS-645120",
  "number": "+12025550147",
  "status": "WAITING_SMS",
  "expires_in": 600
}

GET/api/v1/orders/{id}/smsRetrieve received message and OTP

Response

{
  "status": "SMS_RECEIVED",
  "message": "Your code is 482709",
  "otp": "482709"
}

Status codes

200 — Request succeeded

401 — Invalid API key

404 — Order not found

429 — Rate limit exceeded