Skip to content

CyberSMS — SMS API

/sms/* (Service API)

SMS verification code service — supports purchasing virtual numbers to receive verification codes, as well as sending SMS messages.

Purchase Virtual Number

POST /sms/number

{
  "service": "tg",
  "country": 1
}
FieldTypeDescription
servicestringService code (e.g. tg = Telegram, wa = WhatsApp)
countrynumberCountry code (1 = USA, 86 = China)

Response

{
  "id": "123456789",
  "number": "12025551234"
}

Query Verification Code

GET /sms/status/{id}

GET /sms/status/123456789

Response — Received

{
  "status": "received",
  "code": "123456"
}

Response — Waiting

{
  "status": "STATUS_WAIT_CODE"
}

Purchase Number and Wait for Code

POST /sms/number-and-wait

One step: purchase number → poll and wait for verification code (default 120-second timeout).

{
  "service": "tg",
  "country": 1,
  "timeout": 120
}

Response — Success

{
  "id": "123456789",
  "number": "12025551234",
  "code": "123456"
}

Response — Timeout

{
  "id": "123456789",
  "number": "12025551234",
  "code": null,
  "timeout": true
}

Send SMS

POST /sms/send

{
  "to": "+12025551234",
  "body": "Your verification code is 123456"
}

Response

{
  "sid": "SM1234567890abcdef",
  "status": "queued"
}