Logo
XcelText Public API Documentation

System XcelText

Number of APIs: 5


Return Response Codes

  1. VERIFICATION FAILED => '1501:IP verification failed.',
  2. INVALID KEY => '1502:Invalid api key.',
  3. PROBLEM IN SENDER => '1503:Invalid sender id.',
  4. INVALID MESSAGE => '1504:Invalid message.',
  5. INVALID DESTINATION => '1505:Invalid destination.',
  6. INVALID TYPE => '1506:Invalid message type.',
  7. INSUFFICIENT BALANCE => '1509:Insufficient credit.',
  8. SUCCESS => '1701:Success.',
  9. OPERATOR DOWN => '1801:Operator down.',
  10. SERVER BUSY => '1900:Message enqueued and will be delivered shortly.'

Things to keep in mind:

  1. There should be no space between the above parameters
  2. API user must keep log of all records; our data won't be shared.
  3. Request can be done in any form of web programming language in GET and POST format.
  4. Even Invalid or incomplete request will decrease SMS count. i.e. Balance gets deducted even if request is made with wrong sender id is placed, no mobile number, no message text
  5. Max 75 numbers in single request.
  6. In case we are sending api key in request parameter or request body it should be API_KEY, but in case you are sending it via authorization header it should be API-KEY

Parameter Types:

  • type: it is used for marking message type has unicode characters or not. For plain text messages, it can be 1 and for message with unicode chars it should be 2
  • response_format: this parameter determines whether output/response should be in json format or normal text format. it can have value or JSON or text
  • dlr: it should be always 1
  • source: alias of your sender id, configured by administrator for binding sender id of ntc, ncell and smart together
  • destination: comma separated list of target mobile for delivering sms. eg. 9841963402,9801907481, we can use single mobile no or multiple separated by comma
  • message: the text message to be delivered to destination mobile no as sms


1. SendSMS Single NTC GET

GET {{url}}/send-message?API_KEY={{API_KEY}}&source={{sender_id}}&destination=9841963402&dlr=1&type=1&message=hello&response_format=text



2. SendSMS Multiple Receivers

POST {{url}}/send-message



3. Get Balance

POST {{url}}/get-balance



4. Message Transaction Log

POST {{url}}/message-transaction-log



5. Recharge Transaction Log

POST {{url}}/recharge-transaction-log



ENDPOINTS