For an SMS sent via Exotel SMS API, you can find out the delivery status of the SMS via two means:


A. PULL: You can pull the status by querying Exotel for the specific SMS that you sent. 

For this you need to make a GET request to SMS API


  • Replace <your_api_key> and <your_api_token> with the API key and token created by you. This can be found here:
  • Replace <your_sid> with your “Account sid
  • Replace <subdomain>with the region of your account
    • <subdomain> of Singapore cluster is
    • <subdomain> of Mumbai cluster is

Ex: curl ""

 B. PUSH: You can have Exotel push the SMS status to you after the SMS reaches any terminal state (ie, "sent", "failed" or   "failed-dnd"). 

For this, you need to pass an additional parameter "StatusCallback" along with your other parameters (like 'From', 'To' and 'Body'). 

    => This parameter should be a URL that is hosted by you. Ex:

    => Exotel will make a POST request to the above URL with the following parameters:

  • SmsSid - The Sid (unique id) of the SMS that you got in response to your request
  • To - Mobile number to which SMS was sent
  • Status - one of queued, sending, submitted, sent, failed-dnd, failed
  • SmsUnits - The number of SMS units being sent
  • DetailedStatus - Human readable word that explains what happened to the message
  • DetailedStatusCode - Exotel’s Detailed Status code corresponding to the DetailedStatus
  • DateSent - The date on which the message was sent
  • CustomField - The custom field that was set in the POST request. (Will be returned only if it was set)

DASHBOARD: You can also monitor the status of your SMS from the Outbox section of the dashboard. 

Also, refer to How to check SMS status from the dashboard

SMS STATS: The SMS Stats dashboard gives you a high-level overview of your SMS stats.

The dashboard is accessible as SMS Stats (Beta) under the SMS section of your Exotel portal. 

kindly reach us at +918088919888 or write to us at for any concerns.