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

© 2026 LiSco SMS

TermsPrivacyDelete accountContact

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#

  1. On an Android phone with a SIM card, install the LiSco SMS Gateway app from sms.liscosolutions.com/download.
  2. 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.
  3. 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.

PreviousIntroductionNextAuthentication