Quick start
From zero to a delivered SMS in five steps.
1. Create an account#
Sign up at sms.liscosolutions.com. You get a workspace of your own; your team, phones and API keys belong to it.
2. Link a phone#
- On an Android phone with a SIM card, install the LiSco SMS Gateway app from
sms.liscosolutions.com/download. - In the dashboard open Devices → Link a phone. A QR code and a 6-character pairing code (
XXX-XXX) appear; they are valid for 10 minutes. - In the app, scan the QR code or type the pairing code. The phone shows up under Devices as Online within seconds.
3. Create an API key#
Open API keys & webhooks → Create key, give it a name, and copy the key. It starts with lsk_live_ and is shown only once.
Keep the key on your server. Never put it in a website, a browser extension or a mobile app: anyone who has it can send SMS from your phones.
4. Send your first message#
Replace the key and the number with your own:
curl -X POST "https://sms.liscosolutions.com/v1/messages" \
-H "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"to":"+905321234567","text":"Order #1042 is ready for pickup."}'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: "+905321234567",
text: "Order #1042 is ready for pickup."
}),
});
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" => "+905321234567",
"text" => "Order #1042 is ready for pickup.",
]),
]);
$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": "+905321234567",
"text": "Order #1042 is ready for pickup.",
},
)
print(res.status_code, res.json())Response · 201
{
"id": "6650f1c2e4b0a1b2c3d4e5f6",
"to": "+905321234567",
"text": "Order #1042 is ready for pickup.",
"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"
}The answer comes back at once with status pending; the phone picks the message up within about 3 seconds.
5. Check its status#
Use the id from the answer:
curl "https://sms.liscosolutions.com/v1/messages/6650f1c2e4b0a1b2c3d4e5f6" \
-H "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"const res = await fetch("https://sms.liscosolutions.com/v1/messages/6650f1c2e4b0a1b2c3d4e5f6", {
headers: {
Authorization: "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
},
});
console.log(res.status, await res.json());<?php
$ch = curl_init("https://sms.liscosolutions.com/v1/messages/6650f1c2e4b0a1b2c3d4e5f6");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
],
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
print_r([$status, $body]);import requests
res = requests.get(
"https://sms.liscosolutions.com/v1/messages/6650f1c2e4b0a1b2c3d4e5f6",
headers={"Authorization": "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(res.status_code, res.json())Response · 200
{
"id": "6650f1c2e4b0a1b2c3d4e5f6",
"to": "+905321234567",
"text": "Order #1042 is ready for pickup.",
"status": "delivered",
"deviceId": "6650e0a1e4b0a1b2c3d4e500",
"sim": 1,
"error": null,
"requestId": null,
"createdAt": "2026-11-20T09:15:02.481Z",
"updatedAt": "2026-11-20T09:15:09.210Z",
"expiresAt": "2026-11-21T09:15:02.481Z",
"events": [
{
"at": "2026-11-20T09:15:02.481Z",
"type": "queued",
"deviceId": null,
"sim": null,
"detail": null
},
{
"at": "2026-11-20T09:15:03.902Z",
"type": "claimed",
"deviceId": "6650e0a1e4b0a1b2c3d4e500",
"sim": null,
"detail": null
},
{
"at": "2026-11-20T09:15:06.114Z",
"type": "sent",
"deviceId": "6650e0a1e4b0a1b2c3d4e500",
"sim": 1,
"detail": null
},
{
"at": "2026-11-20T09:15:09.210Z",
"type": "delivered",
"deviceId": "6650e0a1e4b0a1b2c3d4e500",
"sim": 1,
"detail": null
}
]
}events is the message's timeline. For production, don't poll: set up a webhook and LiSco SMS calls your server whenever the status changes.