LocalSMS API

Connect your own panel, bot or automation system to LocalSMS. Use the API to list services, check countries, buy numbers and track SMS codes.

REST API JSON response Fast activation Order status

Your API Key

Keep this key private. Do not share it with anyone.

YOUR_API_KEY

Authentication

GET/POST

Send your API key with every request using the api_key parameter.

https://localsms.shop/api.php?api_key=YOUR_API_KEY&action=balance

Check balance

GET

/api.php?action=balance

Parameter	Required	Description
api_key	Yes	Your API key
action	Yes	balance

{
  "success": true,
  "balance": 12.50,
  "currency": "USD"
}

Get services

GET

/api.php?action=services

https://localsms.shop/api.php?api_key=YOUR_API_KEY&action=services

{
  "success": true,
  "services": [
    {
      "id": 1,
      "name": "Telegram",
      "code": "telegram"
    }
  ]
}

Get countries

GET

/api.php?action=countries&service=telegram

https://localsms.shop/api.php?api_key=YOUR_API_KEY&action=countries&service=telegram

{
  "success": true,
  "countries": [
    {
      "code": "azerbaijan",
      "name": "Azerbaijan",
      "price": 2.00,
      "stock": 134
    }
  ]
}

Buy number

POST

/api.php?action=buy

Parameter	Required	Description
api_key	Yes	Your API key
service	Yes	Service code, example: whatsapp
country	Yes	Country code, example: azerbaijan

curl -X POST "https://localsms.shop/api.php" \
  -d "api_key=YOUR_API_KEY" \
  -d "action=buy" \
  -d "service=whatsapp" \
  -d "country=azerbaijan"

{
  "success": true,
  "order_id": 105,
  "number": "+994501234567",
  "price": 2.00
}

Check order status

GET

/api.php?action=status&order_id=105

https://localsms.shop/api.php?api_key=YOUR_API_KEY&action=status&order_id=105

{
  "success": true,
  "status": "completed",
  "number": "+994501234567",
  "sms_code": "123456"
}

Cancel order

POST

/api.php?action=cancel

curl -X POST "https://localsms.shop/api.php" \
  -d "api_key=YOUR_API_KEY" \
  -d "action=cancel" \
  -d "order_id=105"

{
  "success": true,
  "message": "Order cancelled"
}

Error response

{
  "success": false,
  "error": "Invalid API key"
}

Important: endpoint names may depend on your current api.php logic. This page is documentation and UI for your users.