---
title: How to monitor the status of your SMS?
slug: voice-apis/how-to-monitor-the-status-of-your-sms
createdAt: 2025-10-11T04:43:54.875Z
---

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.&#x20;

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

https\://\<your\_api\_key>:\<your\_api\_token>@\<subdomain>/v1/Accounts/\<ExotelSid>/SMS/Messages/\<SmsSid>&#x20;

- Replace \<your\_api\_key> and \<your\_api\_token> with the API key and token created by you. This can be found here: https\://my.exotel.com/apisettings/site#api-credentials
- Replace \<your\_sid> with your “Account sid”
- Replace \<subdomain>with the region of your account
  - \<subdomain> of Singapore cluster is api.exotel.com
  - \<subdomain> of Mumbai cluster is api.in.exotel.com

Ex: curl "https\://asd23df\:abcdefgh\@api.exotel.com/v1/Accounts/Exotel/SMS/Messages/4dd44cc0f7010ee43ca256126f3efc88"

**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").&#x20;

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

\=> This parameter should be a URL that is hosted by you. Ex: http\://example.com/

\=> 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:&#x20;**&#x59;ou can also monitor the status of your SMS from the Outbox section of the dashboard.&#x20;

![](https://api.archbee.com/api/optimize/SK2urIgCC2ml99YyqWOSl/B8EDewCdZET3r_mnMh98t-20260729-074159.png?1664915077)

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

**SMS STATS:&#x20;**&#x54;he 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.&#x20;
