iSMS Uganda API Documentation

Send SMS messages using our powerful API.

Overview

The iSMS Uganda API allows you to send SMS messages to contacts by making HTTP GET requests to the endpoint.

Base URL: https://ismsug.com/send_sms_api

Each request requires authentication via email and password, along with the message details.

Endpoint

URL: https://ismsug.com/send_sms_api

Method: GET

Headers: Content-Type: application/json

Request Parameters

Parameter Type Description Required
email String Your account email used for authentication. Yes
password String Your account password for authentication. Yes
sender_id String The identifier for the SMS sender e.g ismsug. Yes
phone_number String Comma-separated list of phone numbers in Uganda to receive the SMS. Yes
message String The content of the SMS message. Yes

Response

On success, the API returns a JSON response with the following structure:

{
  "success": true,
  "statusCode": 200,
  "message": "Messages have been sent successfully."
}

Code Examples

Curl

curl -X GET "https://ismsug.com/send_sms_api?email=your_email@example.com&password=your_password&sender_id=ismsug&phone_number=phone_number&message=Hello%20Uganda"

PHP

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ismsug.com/send_sms_api?email=your_email@example.com&password=your_password&sender_id=ismsug&phone_number=phone_number&message=Hello%20Uganda",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Node.js

const axios = require("axios");

axios.get("https://ismsug.com/send_sms_api", {
  params: {
    email: "your_email@example.com",
    password: "your_password",
    sender_id: "ismsug",
    phone_number: "25675********",
    message: "Hello Uganda"
  }
}).then(response => console.log(response.data))
  .catch(error => console.error(error));

Python

import requests

url = "https://ismsug.com/send_sms_api"
params = {
    "email": "your_email@example.com",
    "password": "your_password",
    "sender_id": "ismsug",
    "phone_number": "25675********",
    "message": "Hello Uganda"
}

response = requests.get(url, params=params)
print(response.json())

C#

using System;
using System.Net.Http;
using System.Threading.Tasks;

public async Task SendSmsAsync()
{
    using (HttpClient client = new HttpClient())
    {
        HttpResponseMessage response = await client.GetAsync("https://ismsug.com/send_sms_api?email=your_email@example.com&password=your_password&sender_id=ismsug&phone_number=256755******&message=Hello%20Uganda");
        string result = await response.Content.ReadAsStringAsync();
        Console.WriteLine(result);
    }
}

Go

package main

import (
    "fmt"
    "net/http"
    "io/ioutil"
)

func main() {
    resp, err := http.Get("https://ismsug.com/send_sms_api?email=your_email@example.com&password=your_password&sender_id=ismsug&phone_number=phone_number&message=Hello%20Uganda")
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

Check Balance API

Use this API to check the account balance by providing your email and password.

Endpoint

https://ismsug.com/account_api_balance

Request Parameters

  • email - The account email address
  • password - The account password

Example Request in cURL

curl -X GET "https://ismsug.com/account_api_balance?email=customer1%40ismsug.com&password=DYZ2024kyazanga"

Example Request in PHP

<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://ismsug.com/account_api_balance?email=customer1%40ismsug.com&password=DYZ2024kyazanga",
  CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>