MRAM SMS API Documentation

Wakil Tower (8th Floor), Ta-131

Gulshan Badda Link Road, Dhaka-1212
Email: info@[Link]
Website: [Link]

Table of Contents
1. How to Generate API Key
2. API Parameters
3. Send SMS API
4. Credit Balance API
5. Delivery Report API
6. Inbox Reply API
7. API Key Retrieval
8. Error Codes
9. DLR Status Codes
10. Code Examples

How to Generate API Key

1. Login to the SMS panel
2. Navigate to Developers section
3. Click on Regenerate Key
4. Your API Key will be displayed: demo63************.********

Important: After generating your API key, you must get approval from MRAM SMS authority.
Otherwise, your messages will be automatically denied by the system.
API Parameters
Parameter Type Description

api_key String Your API Key (e.g., demo63************.********)

type String text for normal SMS / unicode for Bangla SMS

senderid String Sender ID (found in Messaging > Sender ID)

contacts String Mobile numbers separated by + (e.g.,

88017XXXXXXXX+88018XXXXXXXX+88019XXXXXXXX)

msg String SMS body content (use URL encoding for special characters like &, $,
@)

scheduledDateTime String Optional - Schedule date and time for SMS delivery

Send SMS API

API URL (GET & POST)

[Link]
{NUMBER}&senderid={ApprovedSenderID}&msg={MessageContent}

One To Many - JSON Format

json
 {
"type": "post",
"url": "[Link]
"data": {
"api_key": "{your api key}",
"senderid": "{sender id}",
"type": "{content type}",
"scheduledDateTime": "{schedule date time}",
"msg": "{your message}",
"contacts": "88017xxxxxxxx+88018xxxxxxxx"
}
}

Many To Many - JSON Format

json

{
"type": "post",
"url": "[Link]
"data": {
"api_key": "{your api key}",
"senderid": "{sender id}",
"scheduledDateTime": "{schedule date time}",
"messages": [
{
"to": "88017xxxxxxxx",
"message": "test sms content …"
},
{
"to": "88018xxxxxxxx",
"message": "test sms content …"
}
]
}
}

Note: The messages parameter expects an array of objects with separate mobile numbers and
SMS text.

Credit Balance API

Check your current SMS credit balance.
API URL:

[Link]

Parameters:

API_KEY : Your API Key (demo63************.********)

Delivery Report API

Get All Delivery Reports

[Link]

Parameters:

API_KEY : Your API Key

Chunk per Call: 100

Get Specific SMS Delivery Report

[Link]

Parameters:

API_KEY : Your API Key

SMS_SHOOT_ID : The SMS ID returned when you submitted the SMS via API

Returns: Array with mobile numbers and their DLR status

Inbox Reply API

Retrieve unread replies from recipients.
API URL:
 [Link]

Parameters:

API_KEY : Your API Key (demo63************.********)

API Key Retrieval

Retrieve your API key using username and password.
API URL:

[Link]

Parameters:

username : Your account User ID used to login

password : Account password that you use to login

Error Codes
Error Code Meaning

1002 Sender Id/Masking Not Found

1003 API Not Found

1004 SPAM Detected

1005 & 1006 Internal Error

1007 Balance Insufficient

1008 Message is empty

1009 Message Type Not Set (text/unicode)

1010 Invalid User & Password

Error Code Meaning

1011 Invalid User Id

1012 Invalid Number

1013 API limit error

1014 No matching template

1015 SMS Content Validation Fails

1016 IP address not allowed!!

DLR Status Codes

Response Code Status

0, 1 Delivered

6 Absent subscriber for SM

32 Undelivered

31 Subscriber Busy

1 SMS Failed

5 Unidentified subscriber

9 Illegal subscriber

36 SMS Failed

34 System failure

8 SMS Failed

400/456 SMSC Timeout-abort

13 Barred subscriber
Code Examples
PHP - One To Many

php

<?php
function send_sms() {
$url = "[Link]
$data = [
"api_key" => "your_api_key",
"type" => "text",
"contacts" => "88017xxxxxxxx+88018xxxxxxxx",
"senderid" => "sender_id",
"msg" => "your_message",
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($ch);
curl_close($ch);

return $response;
}
?>

PHP - Many To Many

php
 <?php
function send_sms() {
$url = "[Link]
$data = [
"api_key" => "your_api_key",
"senderid" => "sender_id",
"messages" => json_encode([
[
"to" => "88017xxxxxxxx",
"message" => "test sms content …"
],
[
"to" => "88018xxxxxxxx",
"message" => "test sms content …"
]
])
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
$response = curl_exec($ch);
curl_close($ch);

return $response;
}
?>

Python - [Link]

python
 import [Link]

conn = [Link]("[Link]")
payload = ''
headers = {}
[Link]("GET", "/smsapi?api_key={APIKEY}&type=text&contacts={NUMBER}&senderid={
res = [Link]()
data = [Link]()
print([Link]("utf-8"))

Python - Requests

python

import requests

url = "[Link]
payload = {}
headers = {}
response = [Link]("GET", url, headers=headers, data=payload)
print([Link])

Java - OkHttp

java

OkHttpClient client = new OkHttpClient().newBuilder()

.build();
Request request = new [Link]()
.url("[Link]
.method("GET", null)
.build();
Response response = [Link](request).execute();

C# ([Link] Compatible)

csharp
 // Required for Bulk SMS
using RestSharp;
using [Link];

// Variables
string varAPI = "your_api_key";
string varCookie = "";
string varSender = "your_sender_id";

private void SendSMS(string contact, string Msg)

{
// API URL
var client = new RestClient("[Link] + varAPI +
[Link] = -1;
var request = new RestRequest([Link]);
[Link]("Cookie", "'" + varCookie + "'");
IRestResponse response = [Link](request);

// Label for show the sending status

[Link] = ([Link]);
}

Contact Information
Address: Wakil Tower (8th Floor), Ta-131, Gulshan Badda Link Road, Dhaka-1212
Email: info@[Link]
Website: [Link]

For technical support and API approval, please contact MRAM SMS authority.