LiSco SMSDocs
Dashboardالعربية
  • Introduction
  • Quick start
  • Authentication
  • Errors
  • Limits
  • Phone numbers
  • Messages
  • Message statuses
  • OTP codes
  • Devices
  • Webhooks
  • Changelog

© 2026 LiSco SMS

TermsPrivacyDelete accountContact

Phone numbers

Send numbers in E.164: a +, the country code and the number, without spaces or a leading 0, for example +905321234567, +491512345678 or +12025550123.

Spaces, dashes and brackets are tolerated (+90 532 123 45 67 works), and the number is stored and returned in E.164. Numbers are checked against real numbering plans: a number that can't exist in its country is refused with invalid_phone.

National numbers#

A national number such as 0532 123 45 67 is accepted only if your workspace has a default country; it is then read as a number of that country and stored in E.164. Without one, national numbers are refused with invalid_phone.

Set it in the dashboard under Settings › Default country (owner or admin). Choose None — international numbers only to accept E.164 numbers only. The setting applies to messages, one-time codes and test messages.

With the default country set to Türkiye, this request is accepted and the number comes back as +905321234567:

curl -X POST "https://sms.liscosolutions.com/v1/messages" \
  -H "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"to":"0532 123 45 67","text":"National number check"}'
const res = await fetch("https://sms.liscosolutions.com/v1/messages", {
  method: "POST",
  headers: {
    Authorization: "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "0532 123 45 67",
    text: "National number check"
  }),
});
console.log(res.status, await res.json());
<?php
$ch = curl_init("https://sms.liscosolutions.com/v1/messages");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "to" => "0532 123 45 67",
    "text" => "National number check",
  ]),
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
print_r([$status, $body]);
import requests

res = requests.post(
    "https://sms.liscosolutions.com/v1/messages",
    headers={"Authorization": "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
    json={
        "to": "0532 123 45 67",
        "text": "National number check",
    },
)
print(res.status_code, res.json())
Response · 201
{
  "id": "6650f1c2e4b0a1b2c3d4e5f6",
  "to": "+905321234567",
  "text": "National number check",
  "status": "pending",
  "deviceId": null,
  "sim": null,
  "error": null,
  "requestId": null,
  "createdAt": "2026-11-20T09:15:02.481Z",
  "updatedAt": "2026-11-20T09:15:02.481Z",
  "expiresAt": "2026-11-21T09:15:02.481Z"
}
E.164 always works, whatever the workspace settings. Prefer it when your numbers come from several countries.

Which numbers can a phone reach?#

The phone sends through its SIM's network, so international numbers cost what your SIM plan charges for them, and some networks don't deliver to every destination. Test a new country with one message first.

PreviousLimitsNextMessages