Skip to main content

Get account balance

GET https://www.lightsms.com/external/get/balance.php

Check your current account balance and currency.

This endpoint allows you to verify your account balance before sending SMS messages to ensure you have sufficient funds.

Authorization​

This endpoint requires authentication using login, signature, and timestamp parameters.

See the Authentication documentation for more details.

Parameters​

Query Parameters​

NameTypeRequiredDescription
loginstring✓Your LightSMS account login
signaturestring✓Request signature for authentication
timestampstring✓UTC timestamp of the request
returnstringResponse format (json or xml)

Example​

Request​

GET https://www.lightsms.com/external/get/balance.php?login=JohnDoe&signature=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6&timestamp=1761188934&return=json

Response​

{
"money": "69573.1",
"currency": "RUB"
}

AUTHORIZATION: HTTP

REQUEST

Base URL
https://www.lightsms.com
Query Parameters
loginREQUIRED
Your LightSMS account login
signatureREQUIRED
Request signature for authentication
timestampREQUIRED
UTC timestamp of the request
return
Response format (json or xml)

RESPONSE

Balance retrieved successfully
{
"money": "69573.1",
"currency": "RUB"
}