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()){
"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"
}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.