Skip to Content
faviconTilil Technologies

Getting Started


Bulk Messaging

Sending a Message

Below is sample send sms JSON data:

{
"api_key": "{{ Test API Key}}",
"service": 0,
"mobile": "0708400000",
"response_type": "json",
"shortcode": "Tilil",
"message": "This is a message.\n\nRegards\nTilil"
}

Where:

VariableTypeDescriptionExample Value
api_keyStringThe authentication string provided to the customer{{ Test API Key}}
shortcodeStringThe origination alphanumeric or numeric codeTilil
messagePreDescription for messageThis is a message.\n\nRegards\nTilil
mobileStringDescription for mobile0708400000
service_idIntDescription for service_id0
response_typeStringDescription for response_typejson

Success Request Response

[
{
"status_code": "1000",
"status_desc": "Success",
"message_id": 288369252,
"mobile_number": "254708400000",
"network_id": "1",
"message_cost": 1,
"credit_balance": 148
}
]

Failed Request Response

[
{
"status_code": "1003",
"status_desc": "Invalid mobile number",
"message_id": "0",
"mobile_number": "123",
"network_id": "",
"message_cost": "",
"credit_balance": ""
}
]

Where:

VariableDescription
status_codeThe numeric status code to help in API integrations.
Please refer to the next table for a description of our status codes.
status_descA short description of the status code
message_idA unique identifier of every message that is successfully accepted
mobile_numberA well-formatted recipient mobile number
network_idThe network identifier of the recipient mobile number
message_costThe amount deducted from your account for this particular message
credit_balanceThe balance remaining in your account after the request

API Status Codes and Descriptions

status_codeStatus Description (status_desc)
0Unknown error
1Success
1000Success
1001Invalid sender name {$senderValue}
1002Network not allowed
1003Invalid mobile number
1004Low bulk credits
1005Failed. System error
1006Invalid credentials
1007Database connection failed
1008Database selection failed
1009No DLR
1009Unsupported data type
1010Unsupported request type
1011Invalid user state

Getting Delivery Reports:

  1. Offline (Pulling – Not recommended)

    This is a pull method where a client requests a delivery report from the system by specifying a message id in the request. The URL below will return a delivery report for message id 288369252.

Key changes:
1. Fixed the formatting of the sendsms JSON data.
2. Ensured proper escaping of characters in the URL.
3. Corrected the formatting of the closing triple backticks for the code block.