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

© 2026 LiSco SMS

TermsPrivacyDelete accountContact

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."
  }
}
PreviousQuick startNextErrors