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

© 2026 LiSco SMS

TermsPrivacyDelete accountContact

Devices

A device is a phone linked to your workspace with the LiSco SMS Gateway app. Link phones in the dashboard under Devices; the API lists them.

List devices#

GET /v1/devices returns the workspace's linked phones (unlinked phones are not included).

curl "https://sms.liscosolutions.com/v1/devices" \
  -H "Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
const res = await fetch("https://sms.liscosolutions.com/v1/devices", {
  headers: {
    Authorization: "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  },
});
console.log(res.status, await res.json());
<?php
$ch = curl_init("https://sms.liscosolutions.com/v1/devices");
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/devices",
    headers={"Authorization": "Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"},
)
print(res.status_code, res.json())
Response · 200
{
  "data": [
    {
      "id": "6650e0a1e4b0a1b2c3d4e500",
      "name": "Shop phone",
      "online": true,
      "lastSeenAt": "2026-11-20T09:15:02.481Z",
      "sims": [
        {
          "slot": 1,
          "carrier": "Turkcell",
          "ready": true
        },
        {
          "slot": 2,
          "carrier": "Vodafone TR",
          "ready": true
        }
      ]
    },
    {
      "id": "6650e0a1e4b0a1b2c3d4e501",
      "name": "Backup phone",
      "online": false,
      "lastSeenAt": "2026-11-20T01:02:44.003Z",
      "sims": [
        {
          "slot": 1,
          "carrier": "Türk Telekom",
          "ready": true
        }
      ]
    }
  ]
}
FieldTypeDescription
idstringUse it as deviceId when sending from a specific phone.
namestringThe name shown in the dashboard.
onlinebooleantrue if the phone pulled within the last 60 seconds.
lastSeenAtstring or nullThe phone's last pull.
simsarrayPer SIM slot: slot (1 or 2), carrier, and ready (the SIM can send now).

What "online" means#

A healthy phone pulls every 3 seconds. If it hasn't pulled for 60 seconds it counts as offline: its messages wait for it or for another phone, and the webhook device.offline is sent once. It is online again with its next pull.

Android may stop apps in the background to save battery. In the phone's settings, allow the LiSco SMS Gateway app to run unrestricted, and keep the phone charging.
PreviousOTP codesNextWebhooks