API documentation

1. Getting a token:

Description: Upon successful execution of this query, you will receive a token. Subsequently, you can use this token to access the server and make additional requests.
Endpoint: https://smsgateway24.com/getdata/gettoken
Method:: GET

Parameters of the request:

Variable	Type	Description
email	string	[required] Your login in the system. Usually email
pass	string	[required] Your password in the system

JSON-formatted response::

Variable	Type	Description
token	string	Your token is acquired through the token retrieval method:
error	int	0 \| 1 - indicates whether there is an error in processing the request
message	string	Error message, empty if everything is in order.

Link to code example Curl
Link to code example Guzzle
Example of the response:
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f41119fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

2. Send single message using TOKEN:

Description: Creates one outgoing message on the server. The message can be sent through the selected channel of your connected Android device.
Endpoint: https://smsgateway24.com/getdata/addsms
Method: GET, POST (Use %2B instead of the plus sign '+' in the GET request)

Parameters of the request:

Variable	Type	Description
token	string	[required] Your token is acquired through the token retrieval method.
sendto	string	[required] Recipient address or phone number. Multiple values can be separated by commas.
body	string	[required] Message body. Not required when sending an image (see the "file" parameter below) — in that case body will be replaced with the uploaded image URL.
device_id	int	[required] Device ID
sim	int	[required] Sim slot: 0 and 1 for SMS. 2 - Whatsapp Business, 3 - WhatsApp Personal. 4 and 5 - RCS.
timetosend	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[optional] Time designated for sending a message. For instance, 2026-05-26 12:10:04
customerid	int	[optional] Your customer's ID number. Optional field
urgent	int	[optional] Marks the message as urgent. Useful for OTP and high-priority traffic.
file	file (multipart/form-data)	[optional] Image file to send (jpeg, png, webp, gif). When provided, the request must be sent as multipart/form-data with POST. The file is uploaded to our S3 storage and its public URL replaces the "body" field, so the image is delivered to the recipient (currently supported on WhatsApp / WhatsApp Business slots) and is also displayed in the corresponding chat. This parameter is fully optional — existing integrations that only send text messages can keep working without any changes.

Backwards compatibility: the "file" parameter is optional. If you do not send a file, the endpoint behaves exactly as before — your existing text-only integrations require no changes.

JSON-formatted response:

Variable	Type	Description
error	int	0 or 1 - indicates whether there is an error in processing the request
message	string	Error message, empty if everything is in order.
sms_id	int	Created message identifier in our system.

Link to code example Curl
Link to code example Guzzle Example of the response:

{
    "error": 0,
    "sms_id": 62807347,
    "message": "Sms has been saved successfully"
}

2.1 Legacy method: send single SMS using login and password

Deprecated. Use token-based authentication for new integrations. This method is kept only for backward compatibility.

Endpoint: https://smsgateway24.com/getdata/smstosend
Method: GET, POST

Parameters of the request:

Variable	Type	Description
email	string	[required] Your email
pass	string	[required] Your password
sendto	string	[required] Recipient address or phone number.
body	string	[required] Message body
device_id	int	[required] Device ID
sim	int	[required] Sim slot: 0 and 1 for SMS. 2 - Whatsapp Business, 3 - WhatsApp Personal. 4 and 5 - RCS
timetosend	string	[optional] Scheduled sending time.
customerid	int	[optional] Your customer identifier.
urgent	int	[optional] Marks the message as urgent.

3. Sending SMS in bulk using JSON

Description: Creates SMS on the server to send. After that, the phone with the Smsgateway24 application calls the server and takes the SMS and sends it from your sim card Download the application at the link
Endpoint: https://smsgateway24.com/getdata/addalotofsms
Method:: GET, POST

Parameters of the request:

Variable	Type	Description
datajson	string	[required] {"token":"df427bfcf113c9a21c67718035076b5b","smsdata":[{"sendto":"015752982212","body":"Test message","sim":1,"timetosend":"2019-07-01 23:50:00","device_id":260},{"sendto":"+4915752982212","body":"Test message 2","sim":1,"timetosend":"2019-07-01 23:50:00","device_id":260,"urgent":1}]}

JSON-formatted response::

Variable	Type	Description
error	int	0 \| 1 - indicates whether there is an error in processing the request
message	string	Error message, empty if everything is in order.

Link to code example Curl
Link to code example Guzzle
Request example:

{
   "token":"df427bfcf113c9a21c6771803501",
   "smsdata":[
        {
            "sendto":"015752982212",
            "body":"Your password is 12345",
            "sim":1,
            "timetosend":"2019-07-01 23:50:00",
            "device_id":260,
            "customerid":122,
            "urgent":1
        },
        {
            "sendto":"015752982212",
            "body":"Regular SMS. Not urgnet",
            "sim":1,
            "timetosend":"2019-07-01 23:50:00",
            "device_id":260,
            "customerid":122,
            "urgent":0
        }
    ]
}

4. Get all SMS (Including incoming SMS):

Description: This request allows you to retrieve all messages associated with your account, including incoming SMS from customers. All input variables are mandatory in this method, and SMS messages may vary in status.
Endpoint: https://smsgateway24.com/getdata/getallsms
Method: GET, POST (Use %2B instead of the plus sign "+" in the GET request)

Parameters of the request:

Variable	Type	Description
token	string	[required] Your token is acquired through the token retrieval method.
device_id	string	[optional] Device ID
status	int	[optional] 1 - Pending SMS 2 - SMS taken by phone 3 - Queued for sending. Certainly, it would have been more logical to place the status "queued for sending" before "SMS taken by phone," but for backward compatibility, the statuses are in the following order: 1, 3, 2." 5 - Incoming SMS 6 - SMS Sent by Phone 7 - SMS has been Delivered 8 - SMS was NOT Delivered 9 - SMS didn't SENT at all - Generic failure. (Read what to do with this error here) Other, less common errors: 10 - SMS Not Sent - No Service 11 - SMS Not Sent - Null PDU 12 - SMS Not Sent - Radio Off 100, 101 - SMS Not Sent - NOT ALLOWED. (Permissions for sending SMS in the application were not granted)
begindate	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[optional] Begin Date Time
enddate	string YYYY-MM-DD or YYYY-MM-DD HH:MM:SS	[optional] End Date Time
sim	int	[optional] Sim slot: 0 and 1 for SMS. 2 - Whatsapp Business, 3 - WhatsApp Personal. 4 and 5 - RCS # 0 or 1
customerid	int	[optional] Your customer's ID number. Optional field
onlycount	int	[optional] 0 \| 1 count only
phone	string	[optional] 0 \| 1 Phone number filter
orderbydesc	int	[optional] 0 \| 1 Order by any field
timezone	int	[optional] Specify your local time zone, such as setting it to Australia/Sydney, for example.

JSON-formatted response::

Variable	Type	Description
token	string	Your token is acquired through the token retrieval method:
error	int	0 \| 1 - indicates whether there is an error in processing the request
message	string	Error message, empty if everything is in order
count	int	SMS amount
smss	int	JSON object

Link to code example Curl
Link to code example Guzzle
Example of the response ... :


            {
    "smss": {
        "62050971": {
            "id": 62050971,
            "sendto": "+4912312312332",
            "body": "Hello! Thank you for Order! ",
            "customerid": null,
            "status": 2,
            "statustitle": "sending",
            "deviceid": 11231,
            "urgent": null,
            "created": {
                "date": "2023-11-02 22:44:43.000000",
                "timezone_type": 3,
                "timezone": "Europe/Paris"
            },
            "senttime": null,
            "timetosend": null,
            "paketid": null,
            "pakettitle": null,
            "paketbody": null
        },
        "62051117": {
            "id": 62051117,
            "sendto": "+4912312312332",
            "body": "Hello! Thank you for Order! ",
            "customerid": null,
            "status": 7,
            "statustitle": "delivered",
            "deviceid": 11231,
            "urgent": null,
            "created": {
                "date": "2023-11-02 22:46:09.000000",
                "timezone_type": 3,
                "timezone": "Europe/Paris"
            },
            "senttime": null,
            "timetosend": null,
            "paketid": null,
            "pakettitle": null,
            "paketbody": null
        }
            }
            }

5. Add a new Contact list

Description: The tag is required for generating a newsletter targeting a group of numbers. For instance, use the tag Employees
Endpoint: https://smsgateway24.com/getdata/savetag
Method:: GET, POST

Parameters of the request:

Variable	Type	Description
token	string	[required] Your token is acquired through the token retrieval method.
title	string	[required] Tag name

JSON-formatted response::

Variable	Type	Description
tag_id	int	Tag ID
error	int	0 \| 1 - indicates whether there is an error in processing the request
message	string	Error message, empty if everything is in order.

Link to code example Curl
Link to code example Guzzle
Example of the response:

{
    "error": 0,
    "tag_id": 8303,
    "message": "OK"
}

6. Add contacts to Contact list:

Description: Add contacts for any tag. For example, for the tag * Employees * your colleagues will perfectly fit.
Endpoint: https://smsgateway24.com/getdata/savecontact
Method:: GET, POST

Parameters of the request:

Variable	Type	Description
token	string	[required] Your token is acquired through the token retrieval method.
phone	string	[required] phone number
ctag_id	int	[required] Tag ID
fullname	string	[required] Your customer's name

JSON-formatted response::

Variable	Type	Description
contact_id	int	Contact Id
error	int	0 \| 1 - indicates whether there is an error in processing the request
message	string	Error message, empty if everything is in order.

Link to code example Curl
Link to code example Guzzle
Example of the response ... :
{"error":0,"contact_id":15954765,"message":"ok"}

7. Create a Newsletter

Description:Once you have created the tag, you can do the mailing on the tag phones.
Endpoint: https://smsgateway24.com/getdata/savepaket
Method:: GET, POST

Parameters of the request:

Variable	Type	Description
token	string	[required] Your token is acquired through the token retrieval method.
title	string	[required] Newsletter title
device_id	string	[required] Device ID
body	string	[required] Target message body
tags	string	[required] Tag Id. Can be several, separated by commas. For example: 12,13,14
sim	int	[required]Sim slot: 0 and 1 for SMS. 2 - Whatsapp Business, 3 - WhatsApp Personal. 4 and 5 - RCS 0 or 1
time_to_send	int, default = 0	[required]Date time when Newsletter should be sent. Do not forget tap start on device. DD.MM.YYYY H:i:s

JSON-formatted response::

Variable	Type	Description
contact_id	int	Contact Id
error	int	0 \| 1 - indicates whether there is an error in processing the request
message	string	Error message, empty if everything is in order.
paket_id	int	Package ID

Link to code example Curl
Link to code example Guzzle
Example of the response ... :
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f4f49fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

8. Get device list

Description: You can find out all about your devices.
Endpoint: https://smsgateway24.com/getdata/getalldevices
Method:: GET, POST

Parameters of the request:

Variable	Type	Description
token	string	[required] Your token is acquired through the token retrieval method.

JSON-formatted response::

Variable	Type	Description
count	int	Number of devices:
device	json	id - Device ID title - Device Name created - Device Creation Date createdhumanformat - Date created device in regular format lastseen - The date the device was last seen lastseenhumanformat - The date the device was last seen serialnumber - Device serial number siminfo - Information about SIM cards in JSON appversion - The version of the application installed on the device subscription - Is there a subscription on the device
message	string	Error message, empty if everything is in order.

Link to code example Curl
Link to code example Guzzle
Example of the response:

    {
    "count": 2,
    "device": {
        "1576": {
            "id": 1576,
            "title": "AOSP_on_IA_Emulator",
            "number": null,
            "imei": "358240051111110",
            "created": {
                "date": "2020-03-28 20:10:29.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "createdhumanformat": "28.03.2020 20:10:29",
            "lastseen": {
                "date": "2020-04-23 17:02:21.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "lastseenhumanformat": "23.04.2020 17:02:21",
            "serialnumber": "EMULATOR30X0X5X0",
            "siminfo": [
                {
                    "Slot": "0",
                    "IccId": "89014103211118510720",
                    "Number": " 15555215554",
                    "Roaming": "0",
                    "CountryIso": "us",
                    "CarrierName": "Android (T-Mobile)"
                }
            ],
            "appversion": "12.1.21",
            "isappversionactual": false,
            "delaybetweeneachsms": null,
            "delaybetweenrequest": 1,
            "subscription": true
        },
        "1297": {
            "id": 1297,
            "title": "Android_SDK_built_for_x86",
            "number": null,
            "imei": "null",
            "created": {
                "date": "2020-01-20 14:01:05.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "createdhumanformat": "20.01.2020 14:01:05",
            "lastseen": {
                "date": "2020-04-20 20:51:34.000000",
                "timezone_type": 3,
                "timezone": "UTC"
            },
            "lastseenhumanformat": "20.04.2020 20:51:34",
            "serialnumber": "unknown",
            "siminfo": [
                {
                    "Slot": "0",
                    "IccId": "8949226172233934327",
                    "Number": "+4915752982212",
                    "Roaming": "1",
                    "CountryIso": "de",
                    "CarrierName": "Drillisch (o2)"
                }
            ],
            "appversion": "12.1.21",
            "isappversionactual": false,
            "delaybetweeneachsms": 5,
            "delaybetweenrequest": 10,
            "subscription": false
        }
    }
}

9. Get the Delivery Status of a single SMS

Description: You can find out the delivery status of each SMS using this method
Endpoint: https://smsgateway24.com/getdata/getsmsstatus
Method:: GET, POST

Parameters of the request:

Variable	Type	Description
token	string	[required] Your token is acquired through the token retrieval method.
sms_id	int	[required] Sms Id

JSON-formatted response::

Variable	Type	Description
sms_id	int	SMS ID
status	int	SMS Status 1 - Pending SMS 2 - SMS taken by phone 3 - Queued for sending. Certainly, it would have been more logical to place the status "queued for sending" before "SMS taken by phone," but for backward compatibility, the statuses are in the following order: 1, 3, 2." 5 - Incoming SMS 6 - SMS Sent by Phone 7 - SMS has been Delivered 8 - SMS was NOT Delivered 9 - SMS didn't SENT at all - Generic failure. (Read what to do with this error here) Other, less common errors: 10 - SMS Not Sent - No Service 11 - SMS Not Sent - Null PDU 12 - SMS Not Sent - Radio Off 100, 101 - SMS Not Sent - NOT ALLOWED. (Permissions for sending SMS in the application were not granted)
status_description	string	Status Name
error	int	0 \| 1 - is there an error in processing the request
message	string	Error message, empty if everything is in order.

Link to code example Curl
Link to code example Guzzle
Example of the response:
{"error":0,"message":"OK","token":"abbde3e31e9d026c02f4f49fc551111e"}
or
{"error":1,"message":"Login or password incorrect"}

Quick access

API and integration documentation

API Reference

SDKs & tools

Plugins & integrations

1. Getting a token:

2. Send single message using TOKEN:

2.1 Legacy method: send single SMS using login and password

3. Sending SMS in bulk using JSON

4. Get all SMS (Including incoming SMS):

5. Add a new Contact list

6. Add contacts to Contact list:

7. Create a Newsletter

8. Get device list

9. Get the Delivery Status of a single SMS

Quick access

Api documentation

API and integration documentation

API Reference

SDKs & tools

Plugins & integrations

1. Getting a token:

2. Send single message using TOKEN:

2.1 Legacy method: send single SMS using login and password

3. Sending SMS in bulk using JSON

4. Get all SMS (Including incoming SMS):

5. Add a new Contact list

6. Add contacts to Contact list:

7. Create a Newsletter

8. Get device list

9. Get the Delivery Status of a single SMS