Authentication
Every request needs an API key in the Authorization header:
Authorization: Bearer lsk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
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
}
]
}
]
}Key format#
A key is lsk_live_ followed by 32 letters and digits. The dashboard shows a key in full once, right after you create it; afterwards only its first 12 and last 4 characters are visible. LiSco SMS stores only a hash of the key, so a lost key can't be recovered: create a new one.
The owner, admins and developers of a workspace can create and revoke keys; viewers can only see the list. How many active keys a workspace may have depends on its plan.
Keep keys on the server#
An API key can send SMS from your phones and spend your plan's messages. Use it only from your own server:
- never in front-end JavaScript, a mobile app or a desktop app that you hand out,
- not in a public repository: load it from an environment variable or a secrets manager,
- one key per system (e.g. "Shop backend", "CRM"), so you can revoke one without touching the others.
Revoking#
Revoke a key under API keys & webhooks. It stops working immediately. A missing, unknown or revoked key gets:
Response · 401
{
"error": {
"code": "invalid_api_key",
"message": "The API key is missing, unknown or revoked."
}
}