Authentication
Every request must include your ApiKey and ClientId. In GET requests pass them as URL-encoded query parameters; in POST/PUT requests include them in the JSON body.
https://smsq.rongoit.com.bd/api/v2
Your API base URL. Get your credentials from the client panel → API Credentials.
| Header | Value |
|---|---|
Content-Type | application/json (or application/xml) |
Accept | application/json |
Credit balance
/Balance?ApiKey={ApiKey}&ClientId={ClientId}Returns the SMS credit balance for the account.
curl "https://smsq.rongoit.com.bd/api/v2/Balance?ApiKey=YOUR_KEY&ClientId=YOUR_ID"
{
"ErrorCode": 0,
"ErrorDescription": "Success",
"Data": [
{ "PluginType": "SMS", "Credits": 699.10 }
]
}
Groups
/Group?ApiKey={ApiKey}&ClientId={ClientId}List all contact groups.
{ "ErrorCode": 0, "ErrorDescription": "Success", "Data": [
{ "GroupId": 33, "GroupName": "Customers", "ContactCount": 21 }
] }
/GroupCreate a new group. Send JSON with GroupName, ApiKey and ClientId.
curl -X POST "https://smsq.rongoit.com.bd/api/v2/Group" \
-H "Content-Type: application/json" \
-d '{"GroupName":"Customers","ApiKey":"YOUR_KEY","ClientId":"YOUR_ID"}'
/Group?id={Id}Rename an existing group (JSON body: GroupName, ApiKey, ClientId).
/Group/{Id}/SubGroupCreate a sub-group under a parent group (JSON body: GroupName, ApiKey, ClientId).
/Group?ApiKey={ApiKey}&ClientId={ClientId}&id={Id}Delete a group.
Sender IDs
/SenderId?ApiKey={ApiKey}&ClientId={ClientId}List sender IDs with approval status and active flag.
{ "ErrorCode": 0, "ErrorDescription": "Success", "Data": [
{ "Id": 94, "Sender-Id": "SMS123", "Purpose": "TEST",
"IsActive": true, "ApproveStatus": "Approved" }
] }
/SenderIdRequest a new sender ID (JSON: SenderId, Purpose, ApiKey, ClientId). New IDs are pending approval.
/SenderId?id={Id}Update a sender ID (JSON: SenderId, Purpose, ApiKey, ClientId).
/SenderId?ApiKey={ApiKey}&ClientId={ClientId}&id={Id}Delete a sender ID.
Templates
/Template?ApiKey={ApiKey}&ClientId={ClientId}List message templates and their approval state.
{ "ErrorCode": 0, "ErrorDescription": "Success", "Data": [
{ "TemplateId": 138, "TemplateName": "Welcome",
"MessageTemplate": "Dear ##Field##, welcome!", "IsApproved": false, "IsActive": true }
] }
/TemplateCreate a template (JSON: TemplateName, MessageTemplate, TemplateId, ApiKey, ClientId).
/Template?id={Id}Update a template (same JSON body as create).
/Template?ApiKey={ApiKey}&ClientId={ClientId}&id={Id}Delete a template.
Sent messages
/SMS?ApiKey={ApiKey}&ClientId={ClientId}&start={start}&length={length}&fromdate={yyyy-mm-dd}&enddate={yyyy-mm-dd}Paginated sent-message report.
{ "ErrorCode": 0, "ErrorDescription": "Success", "Data": {
"messages": [
{ "MobileNumber": "8801XXXXXXXXX", "SenderId": "MYSHOP", "Message": "Hello",
"SubmitDate": "16-Mar-2018 05:12:28 PM", "MessageId": "Smsc1603635", "Status": "DELIVRD" }
],
"total": "100"
} }
/MessageStatus?ApiKey={ApiKey}&ClientId={ClientId}&MessageId={MessageId}Delivery status for one message id.
Send SMS
/SendSMS?ApiKey={ApiKey}&ClientId={ClientId}&SenderId={SenderId}&Message={Message}&MobileNumbers={numbers}Send one message to one or many comma-separated numbers.
| Parameter | Description |
|---|---|
MobileNumbers | Comma-separated numbers, e.g. 8801712345678,8801812345678 |
Is_Unicode | Optional — true/false |
Is_Flash | Optional — true/false |
DataCoding | Optional — 0 GSM, 3 Latin1, 8 UCS2 |
ScheduleTime | Optional — yyyy-MM-dd HH:MM |
GroupId | Optional — send to a saved group |
curl "https://smsq.rongoit.com.bd/api/v2/SendSMS?ApiKey=YOUR_KEY&ClientId=YOUR_ID&SenderId=MYSHOP&Message=Hello&MobileNumbers=8801712345678"
{ "ErrorCode": 0, "ErrorDescription": "Success", "Data": [
{ "MobileNumber": "8801712345678", "MessageId": "3bb944ad-d943-419f-83dc-f979002a8c0b" }
] }
/SendSMSSame parameters in a JSON body, which avoids URL-encoding long messages.
curl -X POST "https://smsq.rongoit.com.bd/api/v2/SendSMS" \
-H "Content-Type: application/json" \
-d '{"SenderId":"MYSHOP","Message":"Hello","MobileNumbers":"8801712345678","ApiKey":"YOUR_KEY","ClientId":"YOUR_ID"}'
Send bulk / personalized SMS
/SendBulkSMSSend a different message to each number using MessageParameters.
curl -X POST "https://smsq.rongoit.com.bd/api/v2/SendBulkSMS" \
-H "Content-Type: application/json" \
-d '{"SenderId":"MYSHOP","ApiKey":"YOUR_KEY","ClientId":"YOUR_ID",
"MessageParameters":[
{"Number":"8801712345678","Text":"Hello Ayesha"},
{"Number":"8801812345678","Text":"Hello Rahim"}
]}'
/SendBulkSMS?ApiKey={ApiKey}&ClientId={ClientId}&SenderId={SenderId}&MobileNumber_Message=number^text~number^textBulk send via GET (URL-encode the MobileNumber_Message value).
Error codes
Check ErrorCode in every response. 0 means success.
| Code | Meaning |
|---|---|
| 0 | Success — message submitted; inspect the per-number MessageId result. |
| 001 | Account details cannot be blank |
| 003 | SenderId cannot be blank |
| 004 | Message cannot be blank |
| 005 | Message properties cannot be blank |
| 006 | Internal server error occurred |
| 007 | Invalid ApiCredentials |
| 009 | User account locked — contact your administrator |
| 010 | Unauthorized API access |
| 011 | Unauthorized IP address |
| 012 | Message length violation |
| 013 | Invalid mobile numbers |
| 015 | Invalid SenderId |
| 017 | Invalid group id |
| 018 | Group not allowed in BulkSMS |
| 019 | Invalid schedule date |
| 020 | Message or mobile number cannot be blank |
| 023 | Parameter missing |
| 024 | Invalid template or template mismatch |
| 026 | Invalid date range |
| 028 | Group not found |
| 029 | Record already exists |
| 033 | Queue connection closed |
| 034 | Unable to create campaign at this time — try again later |
| 036 | Error while publishing DLR |
| 041 | Report not found |
| 042 | Maximum mobile number limit exceeded |
| 1025 | Insufficient credits |
| 1026 | Invalid template while message processing |
| 1029 | Invalid SenderId while message processing |
| 1044 | Spam message detected |
| 1047 | User account inactive |
| 1081 | Country not found in master data |
| 1082 | Network not found |
| 1083 | Price not found |
| 1084 | Expired |
| 1085 | Route not found |
| 1086 | Failover route not found |
| 1087 | Failover expired |
| 1088 | Failover price not found |
| 1089 | Failover failed |
| 1090 | Account validity expired |
| 1091 | Encoding error |
| 1092 | OA/DA error |
| 1093 | Queue message expired |
| 1094 | Invalid HTTP gateway config |
| 1095 | HTTP request exception |