Send SMS

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

Send an SMS message to one or multiple phone numbers.

Bulk Sending

To send the same message to multiple recipients, provide multiple phone numbers separated by commas (maximum 100 phone numbers per request).

Scheduled Sending

Use the sendingTime parameter to schedule SMS for future delivery. Format: YYYY-MM-DD HH:MM:SS

Error Codes

• 0 - Success - message sent
• 1 - Signature not specified
• 2 - Login not specified
• 3 - Text not specified
• 4 - Phone number not specified
• 5 - Sender not specified
• 6 - Invalid signature
• 7 - Invalid login
• 8 - Invalid sender name
• 9 - Sender name not registered
• 10 - Sender name not approved
• 11 - The text contains forbidden words
• 12 - Error sending SMS
• 13 - Phone number is blacklisted. Sending SMS to this number is forbidden.
• 14 - The request contains more than 50 numbers
• 15 - List not specified
• 16 - Invalid phone number
• 17 - SMS ID not specified
• 18 - Status not obtained
• 19 - Empty response
• 20 - Phone number already exists
• 21 - Name not specified
• 22 - Template already exists
• 23 - Month not specified (Format: YYYY-MM)
• 24 - Timestamp not specified
• 25 - Error accessing the list
• 26 - No numbers in the list
• 27 - No valid numbers
• 28 - Start date not specified (Format: YYYY-MM-DD)
• 29 - End date not specified (Format: YYYY-MM-DD)
• 30 - Date not specified (Format: YYYY-MM-DD)
• 31 - Direction to the user is closed
• 32 - Insufficient funds
• 33 - Phone number not set
• 34 - Phone number is in the stop list
• 35 - Insufficient funds
• 36 - Cannot obtain phone information
• 37 - Base ID not set
• 38 - Phone number already exists in this base
• 39 - Phone number does not exist in this base

Message Length

• Standard SMS: 160 characters per message
• Long SMS: Automatically split into multiple messages (153 characters each)
• Unicode SMS: 70 characters for messages with special characters/emojis

Authorization

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

See the Authentication documentation for more details.

Parameters

Query Parameters

Name	Type	Required	Description
login	string	✓	Your LightSMS account login
signature	string	✓	Request signature for authentication
phone	string	✓	One or multiple phone numbers (comma-separated, max 100)
text	string	✓	SMS message text
sender	string	✓	Sender name (approved in your account)
timestamp	string	✓	UTC timestamp of the request
sendingTime	string		Schedule SMS for future delivery (format YYYY-MM-DD HH:MM:SS)
return	string		Response format (json or xml)

Example

Request

GET https://www.lightsms.com/external/get/send.php?login=JohnDoe&signature=cde12435b3b5dd7bf3f1d01c1a52336&phone=37068458719&text=Hello!&sender=YourBrand&timestamp=1409887191&sendingTime=2024-12-31 14:06:30&return=json

Response

{
  "37068458719": {
    "error": "0",
    "id_sms": "4092113103483809600001",
    "cost": "0.5",
    "count_sms": "1"
  }
}

AUTHORIZATION: HTTP

REQUEST

Base URL

https://www.lightsms.com

Query Parameters

loginREQUIRED

Your LightSMS account login

signatureREQUIRED

Request signature for authentication

phoneREQUIRED

One or multiple phone numbers (comma-separated, max 100)

textREQUIRED

SMS message text

senderREQUIRED

Sender name (approved in your account)

timestampREQUIRED

UTC timestamp of the request

sendingTime

Schedule SMS for future delivery (format YYYY-MM-DD HH:MM:SS)

return

Response format (json or xml)

RESPONSE

SMS sent successfully

{
  "37068458719": {
    "error": "0",
    "id_sms": "4092113103483809600001",
    "cost": "0.5",
    "count_sms": "1"
  }
}