Send Bulk SMS (GET)

curl --request GET \
  --url https://api.example.com/api/v2/SendBulkSMS

{
  "ErrorCode": 123,
  "ErrorDescription": "<string>",
  "Data": [
    {}
  ],
  "Data[].MobileNumber": "<string>",
  "Data[].MessageId": "<string>"
}

Send Bulk SMS (GET)

curl --request GET \
  --url https://api.example.com/api/v2/SendBulkSMS

{
  "ErrorCode": 123,
  "ErrorDescription": "<string>",
  "Data": [
    {}
  ],
  "Data[].MobileNumber": "<string>",
  "Data[].MessageId": "<string>"
}

Send Bulk SMS (GET)

Send bulk SMS messages using the GET method with encoded message parameters. This method allows sending different messages to different recipients in a single request.

curl -X GET "https://app.notify.ng/api/v2/SendBulkSMS?ApiKey=YOUR_API_KEY&ClientId=YOUR_CLIENT_ID&SenderId=YOUR_SENDER_ID&MobileNumber_Message=1234567890%5EHello%20John%7E0987654321%5EHello%20Jane&Is_Unicode=false&Is_Flash=false"

// Encode the bulk message parameter
const bulkMessage = "1234567890^Hello John~0987654321^Hello Jane";
const encodedBulkMessage = encodeURIComponent(bulkMessage);

const params = new URLSearchParams({
  ApiKey: 'YOUR_API_KEY',
  ClientId: 'YOUR_CLIENT_ID',
  SenderId: 'YOUR_SENDER_ID',
  MobileNumber_Message: encodedBulkMessage,
  Is_Unicode: 'false',
  Is_Flash: 'false'
});

const response = await fetch(`https://app.notify.ng/api/v2/SendBulkSMS?${params}`, {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json'
  }
});

const data = await response.json();
console.log(data);

import requests
from urllib.parse import quote

# Prepare bulk message parameter
bulk_message = "1234567890^Hello John~0987654321^Hello Jane"
encoded_bulk_message = quote(bulk_message)

url = "https://app.notify.ng/api/v2/SendBulkSMS"
params = {
    "ApiKey": "YOUR_API_KEY",
    "ClientId": "YOUR_CLIENT_ID",
    "SenderId": "YOUR_SENDER_ID",
    "MobileNumber_Message": encoded_bulk_message,
    "Is_Unicode": "true",
    "Is_Flash": "false"
}

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

Parameters

string

required

Your API key for authentication

string

required

Your client identifier for authentication

string

required

Approved sender ID for the messages

string

required

Encoded bulk message parameter (see format below)

boolean

Set to true for Unicode messages (default: false)

boolean

Set to true for flash messages (default: false)

string

Schedule time in yyyy-MM-dd HH:MM format (optional)

MobileNumber_Message Format

The MobileNumber_Message parameter uses a specific format:

{phone1}^{message1}~{phone2}^{message2}~{phone3}^{message3}

Format Rules

Use ^ to separate phone number from message
Use ~ to separate different phone/message pairs
URL encode the entire parameter

Example

1234567890^Hello John~0987654321^Hello Jane~5555555555^Hello Bob

URL Encoded Example

1234567890%5EHello%20John%7E0987654321%5EHello%20Jane%7E5555555555%5EHello%20Bob

Response

number

Error code (0 for success)

string

Description of the result

array

Array of message results

string

Mobile number that received the message

string

Unique message ID for tracking

Success Response

{
  "ErrorCode": 0,
  "ErrorDescription": "Success",
  "Data": [
    {
      "MobileNumber": "7894561230",
      "MessageId": "fc103131-5931-4530-ba8e-aa223c769536"
    },
    {
      "MobileNumber": "7894561231",
      "MessageId": "f893293d-d6ea-45e8-b543-40f0df28e0c9"
    }
  ]
}

Encoding Examples

JavaScript

const messages = [
  { phone: "1234567890", message: "Hello John" },
  { phone: "0987654321", message: "Hello Jane" }
];

const bulkMessage = messages
  .map(m => `${m.phone}^${m.message}`)
  .join('~');

const encoded = encodeURIComponent(bulkMessage);

Python

messages = [
    {"phone": "1234567890", "message": "Hello John"},
    {"phone": "0987654321", "message": "Hello Jane"}
]

bulk_message = "~".join([f"{m['phone']}^{m['message']}" for m in messages])
encoded = quote(bulk_message)

Use Cases

Personalized bulk messaging: Send different messages to different recipients
Marketing campaigns: Send targeted messages to customer segments
Notifications: Send different notification types to different users
Appointment reminders: Send personalized reminders with different details

Authentication

Credit Balance

SMS Management

Group Management

Sender ID Management

Template Management

Webhooks

Error Handling

Send Bulk SMS (GET)

Send Bulk SMS (GET)

Parameters

MobileNumber_Message Format

Format Rules

Example

URL Encoded Example

Response

Success Response

Encoding Examples

JavaScript

Python

Use Cases

​Send Bulk SMS (GET)

​Parameters

​MobileNumber_Message Format

​Format Rules

​Example

​URL Encoded Example

​Response

​Success Response

​Encoding Examples

​JavaScript

​Python

​Use Cases

Send Bulk SMS (GET)

Parameters

MobileNumber_Message Format

Format Rules

Example

URL Encoded Example

Response

Success Response

Encoding Examples

JavaScript

Python

Use Cases