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
}
]
}
]
}| Field | Type | Description |
|---|---|---|
id | string | Use it as deviceId when sending from a specific phone. |
name | string | The name shown in the dashboard. |
online | boolean | true if the phone pulled within the last 60 seconds. |
lastSeenAt | string or null | The phone's last pull. |
sims | array | Per 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.