SMS Details

Retrieve the details and delivery status of a specific SMS message.

GET/v1/Accounts/{sid}/SMS/Messages/{SmsSid}

Endpoint

GET https://<api_key>:<api_token><subdomain>/v1/Accounts/<account_sid>/SMS/Messages/<SmsSid>

Path Parameters

Parameter	Required	Description
SmsSid	Mandatory	The unique SMS identifier returned when the message was sent

Code Examples

cURL

curl https://<your_api_key>:<your_api_token>@api.exotel.com/v1/Accounts/<your_sid>/SMS/Messages/<SmsSid>.json

Python

import requests

response = requests.get(
    'https://<your_api_key>:<your_api_token>@api.exotel.com/v1/Accounts/<your_sid>/SMS/Messages/<SmsSid>.json'
)

print(response.json())

Node.js

const apiKey = '<your_api_key>';
const apiToken = '<your_api_token>';
const accountSid = '<your_sid>';

const url = `https://api.exotel.com/v1/Accounts/${accountSid}/SMS/Messages/<SmsSid>.json`;

const response = await fetch(url, {
  headers: {
    'Authorization': 'Basic ' + Buffer.from(`${apiKey}:${apiToken}`).toString('base64'),
  },
});

const data = await response.json();
console.log(data);

Response

{
  "SMSMessage": {
    "Sid": "sms_sid_value",
    "AccountSid": "your_sid",
    "From": "EXOTEL",
    "To": "+919876543210",
    "Body": "Your OTP is 123456",
    "Status": "sent",
    "DetailedStatusCode": 20005,
    "DetailedStatus": "DELIVERED_TO_HANDSET",
    "DateCreated": "2024-01-15 10:30:00",
    "DateUpdated": "2024-01-15 10:30:05",
    "DateSent": "2024-01-15 10:30:02",
    "Price": 0.18,
    "Uri": "/v1/Accounts/your_sid/SMS/Messages/sms_sid_value"
  }
}

Response Fields

Field	Type	Description
Sid	String	Unique SMS identifier
Status	String	High-level status: queued, sending, submitted, sent, failed, failed-dnd
DetailedStatusCode	Integer	Numeric status code (see Status Codes)
DetailedStatus	String	Human-readable status description
DateCreated	DateTime	When the request was received
DateSent	DateTime	When the SMS was sent to the operator
DateUpdated	DateTime	Last status update timestamp
Price	Double	Amount charged

Try It