Skip to main content

No project description provided

Project description

RestSMSGateway :love_letter:

Unofficial Library

REST SMS Gateway allows to change your phone into a powerful SMS Gateway which you can control from a computer.

Getting Started

Note: The computer (that will run the script) and your phone have to be connected on the same network. Android only!

First of all, you have to install Rest SMS Gateway on your Android phone.

Open the app and press the start button. You'll need the IP address shown in there (e.g,


Easy-peasy! You only need to run one command

pip install rest-sms-gateway

Running the tests

Note: My mistake!

We don't have test yet.


Import and configure the client:

>>> from rest_sms_gateway import SMSGatewayClient 
>>> client = SMSGatewayClient('')

Now, you can do what you want (or almost)!

Let's list all conversations available in the mobile phone:

>>> client.get_thread() 

# {'threads': [{'timestamps': {'update': '1544785173349'}, '_id': '95'},
# {'timestamps': {'update': '1544751618760'}, '_id': '94'},
# {'timestamps': {'update': '1544751384521'}, '_id': '93'},
# {'timestamps': {'update': '1544115829308'}, '_id': '92'},
# {'timestamps': {'update': '1543572583029'}, '_id': '91'},
# {'timestamps': {'update': '1543275852269'}, '_id': '90'},
# {'timestamps': {'update': '1544204987635'}, '_id': '89'},
# {'timestamps': {'update': '1541087704128'}, '_id': '88'},
# {'timestamps': {'update': '1540053558537'}, '_id': '87'},
# {'timestamps': {'update': '1539808989397'}, '_id': '86'}],
# 'size': 10,
# 'limit': '10',
# 'offset': '0'}

>>> client.get_thread(limit=2) 

# {'threads': [{'timestamps': {'update': '1544785173349'}, '_id': '95'},
# {'timestamps': {'update': '1544751618760'}, '_id': '94'}],
# 'size': 2,
# 'limit': '2',
# 'offset': '0'}

And now, send a message!

>>> sender = client.send_sms('+5511987654321', 'Your first message') # Single SMS
>>> if sender['ok']: # or sender['status_code'] == 200
...     print('Message sent!')

# OR

>>> friends_numbers = ['+5511987654321', '+5511987654322', '+5511987654323']
>>> for friend in friends_numbers: # Bulk SMS 
...     client.send_sms(friend, "Hey, let's play BroForce!")


If you're trying to send lot of messages at once, read this article about "Messaging is sending a large amount of messages".

In my tests, this notification only appears after sending 30 messages. An alternative way out for this is:

>>> from rest_sms_gateway import SMSGatewayClient
>>> import time
>>> client = SMSGatewayClient('')
>>> for msg_number in range(60):
...     client.send_sms('+5511987654321', 'Your msg here!')
...     if (msg_number+1) % 30 == 0:
...         # Every 30 messages, an interval of 30 seconds is given
...         time.sleep(30)
...     else:
...         # An interval of 1.5 seconds is given for each message
...         time.sleep(1.5)

Also be careful with your phone carrier, they may be slow with the high demand for messages and/or send the messages out of order.


See also the list of contributors who participated in this project.


This project is licensed under the GNU Lesser General Public License v3 (LGPLv3) - see the LICENSE file for details


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for rest-sms-gateway, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size rest_sms_gateway-0.2.1-py3-none-any.whl (17.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size rest_sms_gateway-0.2.1.tar.gz (19.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page