API DOCUMENTATION

Introduction

Welcome to the NatoliTech SMS Gateway API. This powerful REST API allows you to send SMS messages to one or multiple recipients with ease.

🚀 Getting Started

Our API provides a simple and reliable way to integrate SMS functionality into your applications. Whether you need to send single messages or bulk SMS campaigns, we've got you covered.

Key Features

✅ Bulk SMS sending capabilities
✅ Real-time delivery reports
✅ Multiple format support (JSON)
✅ Comprehensive error handling

Base URL

https://sms.natolitechgroup.com/api/

Authentication

All API requests require authentication using your username and password credentials.

Security Note: Always use HTTPS when making API calls to protect your credentials.

Authentication Methods

Authentication is performed by including your credentials in the request body:

{
                                            "username": "your_username",
                                            "password": "your_password"
                                        }

Getting Your Credentials

To obtain your API credentials:

Sign up for a NatoliTech SMS account
Use your Login credentials username and password for the API

SMS API

Send SMS messages to one or multiple recipients using our bulk SMS endpoint.

Endpoint

                                        POST
                                        https://sms.natolitechgroup.com/api/json/bulk/sms
                                    

Header

                                        Content-Type
                                        application/json
                                    

Request Parameters

Parameter	Type	Required	Description
`username`	String	Yes	Your API username
`password`	String	Yes	Your API password
`msg_ref`	String	Yes	unique message reference
`message`	String	Yes	The SMS message content (max 160 characters)
`recipient`	Array	Yes	Array of phone numbers (international format)
`source`	String	Yes	e.g Marketing Campaign
`senderid`	String	No	Custom sender ID (max 11 characters)

Example Request


                                                    {
                                                    "username": "your_username",
                                                    "password": "your_password",
                                                    "message": "Hello from NatoliTech SMS!",
                                                    "msg_ref": "campaign001-2025-03-003",
                                                    "recipient": [
                                                        "260970000000",
                                                        "260960000000"
                                                    ],
                                                    "senderid": "NatoliTech",
                                                    "source": "Marketing Campaign"
                                                   
                                                    }

Example Response


                                                {
                                                    "response": [
                                                        {
                                                            "messageid": "f55159bc-9a78-4450-9f71-69e7ab62a92b",
                                                            "messagestatus": "SUCCESS",
                                                            "mobile": "260970000000"
                                                        },
                                                        {
                                                            "messageid": "33ce1894-42b0-41ba-85a5-97431618f3cf",
                                                            "messagestatus": "SUCCESS",
                                                            "mobile": "260960000000"
                                                        }
                                                    ]
                                                }

Error Codes

Application-specific error codes and their meanings.

Error Code	Description	Solution
`AUTHENTICATION_FAILED`	Invalid username or password	Check your credentials
`INVALID_REQUEST`	Message too long or the request parameters are invalid or incomplete	Limit message to 160 characters
`INVALID_SENDER_ID`	The sender ID is not registered or approved	check sender ID
`INSUFFICIENT_BUNDLE_LIMIT`	Insufficient balance	Top up your account

NatoliTech SMS Gateway API Documentation