Check if number is blacklisted

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

Check if a phone number is in your blacklist (stop list).

Numbers in the blacklist will not receive SMS messages from your account. This is useful for honoring opt-out requests and maintaining compliance with SMS regulations.

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
timestamp	string	✓	UTC timestamp of the request
phone	string	✓	Phone number to check
return	string		Response format (json or xml)

Example

Request

GET https://www.lightsms.com/external/get/find_on_stop.php?login=JohnDoe&signature=abc123&phone=37068458719&timestamp=1761188934&return=json

Response

{
  "blacklisted": true,
  "added_at": "2024-01-10 15:30:00"
}

AUTHORIZATION: HTTP

REQUEST

Base URL

https://www.lightsms.com

Query Parameters

loginREQUIRED

Your LightSMS account login

signatureREQUIRED

Request signature for authentication

phoneREQUIRED

Phone number to check

timestampREQUIRED

UTC timestamp of the request

return

Response format (json or xml)

RESPONSE

Blacklist check completed

{
  "time_in": "2014-08-29 11:07:43",
  "description": "descr"
}