SMS

An SMS represents an inbound or outbound SMS message. Using this API you can do things like:

Sending an SMS to a mobile number and optionally get notified of its delivery status
Sending a text message to a VoIP Restcomm Client, representing a registered software or hardware SIP phone.
Querying details for already exchanged SMS messages

Send SMS

POST /restcomm/2012-04-24/Accounts/{accountSid}/SMS/Messages

Sends a new SMS and returns its representation:

If the recipient of the SMS is a mobile number the message is routed to the mobile network and delivered to the mobile device.
If the recipient is a registered Restcomm Client then a SIP message is generated and routed to the VoIP client, provided that the Restcomm Client is registered. Notice that in this case the recipient client name needs to be prefixed with the string client: in the To parameter described below

Body Parameter	Description
From	Phone number or short code to be used as the message sender. This number needs to be SMS-enabled in the Restcomm Platform (Required).
To	Phone number, short code or Restcomm client to which the message will be sent to. Needs to be in E.164 format in case of a phone number. In case of a Restcomm client, the client name needs to be prefixed with the string 'client:' (Required).
Body	Text body of the SMS message (Required).
StatusCallback	A URL for Restcomm Platform to send webhook requests to notify on any SMS delivery status event. Notice that StatusCallback is not applicable to messages addressed to Restcomm Clients. For more information check below (Optional).

Body Parameter

Description

From

Phone number or short code to be used as the message sender. This number needs to be SMS-enabled in the Restcomm Platform (Required).

Phone number, short code or Restcomm client to which the message will be sent to. Needs to be in E.164 format in case of a phone number. In case of a Restcomm client, the client name needs to be prefixed with the string 'client:' (Required).

Body

Text body of the SMS message (Required).

StatusCallback

A URL for Restcomm Platform to send webhook requests to notify on any SMS delivery status event. Notice that StatusCallback is not applicable to messages addressed to Restcomm Clients. For more information check below (Optional).

Status Callback

The StatusCallback body parameter allows you to specify a URL where you can receive events in the form of HTTP POST requests (webhooks) with updates on SMS delivery status from the Restcomm Platform. Those requests can contain the following body parameters:

Body Parameter	Description
MessageSid	Message Sid for the SMS that triggered this status callback request.
MessageStatus	Updated status for the SMS. The value is one of the following: sent, failed, delivered, undelivered. For more details please refer to the events description below.
ErrorCode	Error code associated with the sent SMS. The exact format of the error may depend on the provider (only present if an error occurred).
AccountSid	Account Sid for the account that sent the SMS that triggered this status callback request.
From	Sender of the SMS that triggered this status callback request.
To	Recipient of the SMS that triggered this status callback request.
Body	The text body of the SMS that triggered this status callback request.

Body Parameter

Description

MessageSid

Message Sid for the SMS that triggered this status callback request.

MessageStatus

Updated status for the SMS. The value is one of the following: sent, failed, delivered, undelivered. For more details please refer to the events description below.

ErrorCode

Error code associated with the sent SMS. The exact format of the error may depend on the provider (only present if an error occurred).

AccountSid

Account Sid for the account that sent the SMS that triggered this status callback request.

From

Sender of the SMS that triggered this status callback request.

Recipient of the SMS that triggered this status callback request.

Body

The text body of the SMS that triggered this status callback request.

The following two events are supported, in the provided order:

Sent status event, indicating whether Restcomm managed to successfully forward the SMS to the provider for further routing. The status is reflected on MessageStatus attribute described above and can be either sent on success or failed on failure. In case of failure no delivery status event is sent (see below).
Delivery status event, indicating whether the provider managed to successfully deliver the SMS to the destination, given that the sent status event previously was sent. The status is reflected on MessageStatus attribute described above and can be delivered, undelivered or failed

Examples

Send an SMS message from 19876543212 to 13216549878 and also use a status callback URL so that you are notified of the SMS delivery status in the provided callback URL. Make sure that the provided callback URL is reachable from the internet:

curl -X POST https://mycompany.restcomm.com/restcomm/2012-04-24/Accounts/ACCOUNT_SID/SMS/Messages.json \
   -d 'From=19876543212' \
   -d 'To=13216549878' \
   -d 'Body=Test SMS' \
   -d 'StatusCallback=http://status.callback.url' \
   -u 'YourAccountSid:YourAuthToken'

const request = require('request');

// Provide your Account Sid and Auth Token from your Console Account page
const ACCOUNT_SID = 'my_ACCOUNT_SID';
const AUTH_TOKEN = 'my_AUTH_TOKEN';

request.({
      method: 'POST',
      url: 'https://mycompany.restcomm.com/restcomm/2012-04-24/Accounts/' + ACCOUNT_SID + '/SMS/Messages.json',
      auth: { 'user': ACCOUNT_SID, 'pass': AUTH_TOKEN },
      form: {
         'From': '19876543212',
         'To': '13216549878',
         'Body': 'Test SMS',
         'StatusCallback': 'http://status.callback.url'
      }
   },
   function (error, response, body) {
      // Add your business logic below; status can be found at 'response.statusCode' and response body at 'body'
      ...
});

from http.client import HTTPSConnection
from base64 import b64encode
from urllib.parse import urlencode

# Provide your Account Sid and Auth Token from your Console Account page
ACCOUNT_SID = 'my_ACCOUNT_SID'
AUTH_TOKEN = 'my_AUTH_TOKEN'

userAndPass = b64encode(bytes(ACCOUNT_SID + ':' + AUTH_TOKEN, 'utf-8')).decode("ascii")
headers = { 'Authorization' : 'Basic %s' %  userAndPass,
            'Content-type': 'application/x-www-form-urlencoded',
            'Accept': 'text/plain' }

# Update POST parameters accordingly
params = urlencode({
   'From': '19876543212',
   'To': '13216549878',
   'Body': 'Test SMS',
   'StatusCallback': 'http://status.callback.url'
})

conn = HTTPSConnection('mycompany.restcomm.com')
conn.request("POST", '/restcomm/2012-04-24/Accounts/' + ACCOUNT_SID + '/SMS/Messages.json',
      params, headers=headers)
res = conn.getresponse()

// Add your business logic below; status can be found at 'res.status', reason at 'res.reason' and response body can be retrieved with res.read()
...

import java.net.URL;
import javax.net.ssl.HttpsURLConnection;
import java.io.*;
import java.util.Base64;

public class JavaSampleClass {
   // Provide your Account Sid and Auth Token from your Console Account page
   public static final String ACCOUNT_SID = "my_ACCOUNT_SID";
   public static final String AUTH_TOKEN = "my_AUTH_TOKEN";


   public static void main(String[] args) throws Exception {
      String userAndPass = ACCOUNT_SID + ':' + AUTH_TOKEN;
      String encoded = Base64.getEncoder().encodeToString(userAndPass.getBytes());

      URL url = new URL(("https://mycompany.restcomm.com/restcomm/2012-04-24/Accounts/" + ACCOUNT_SID + "/SMS/Messages.json");
      HttpsURLConnection conn = (HttpsURLConnection)url.openConnection();
      conn.setRequestProperty("Authorization", "Basic " + encoded);
      conn.setRequestMethod("POST");
      conn.setDoOutput(true);
      DataOutputStream os = new DataOutputStream(conn.getOutputStream());

      // Update POST parameters accordingly
      os.writeBytes("From=19876543212&" +
        "To=13216549878&" +
        "Body=Test SMS&" +
        "StatusCallback=http://status.callback.url");
      os.close();

      // Add your business logic below; response code can be obtained from 'conn.getResponseCode()' and input stream from 'conn.getInputStream()'
      ...
  }
}

Example response:

{
  "sid": "SM5dd70f7ea54e47f1a49749debeec3f7f",
  "date_created":"Thu, 19 Nov 2015 07:21:35 -0500",
  "date_updated":"Thu, 19 Nov 2015 07:21:35 -0500",
  "account_sid":"ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "from":"19876543212",
  "to":"13216549878",
  "body":"Test SMS",
  "status":"sending",
  "direction":"outbound-api",
  "price":"0",
  "price_unit":"USD",
  "api_version":"2012-04-24",
  "uri":"/restcomm/2012-04-24/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/SMS/Messages/SM5dd70f7ea54e47f1a49749debeec3f7f.json"
}

Send a (SIP) message from 19876543212 to Restcomm Client alice. Notice the client: prefix in the To (remember that this client needs to be registered):

curl -X POST https://mycompany.restcomm.com/restcomm/2012-04-24/Accounts/ACCOUNT_SID/SMS/Messages.json \
   -d 'From=19876543212' \
   -d 'To=client:alice8' \
   -d 'Body=Test SIP message' \
   -d 'StatusCallback=http://status.callback.url' \
   -u 'YourAccountSid:YourAuthToken'

const request = require('request');

// Provide your Account Sid and Auth Token from your Console Account page
const ACCOUNT_SID = 'my_ACCOUNT_SID';
const AUTH_TOKEN = 'my_AUTH_TOKEN';

request.({
      method: 'POST',
      url: 'https://mycompany.restcomm.com/restcomm/2012-04-24/Accounts/' + ACCOUNT_SID + '/SMS/Messages.json',
      auth: { 'user': ACCOUNT_SID, 'pass': AUTH_TOKEN },
      form: {
         'From': '19876543212',
         'To': 'client:alice8',
         'Body': 'Test SIP message',
         'StatusCallback': 'http://status.callback.url'
      }
   },
   function (error, response, body) {
      // Add your business logic below; status can be found at 'response.statusCode' and response body at 'body'
      ...
});

from http.client import HTTPSConnection
from base64 import b64encode
from urllib.parse import urlencode

# Provide your Account Sid and Auth Token from your Console Account page
ACCOUNT_SID = 'my_ACCOUNT_SID'
AUTH_TOKEN = 'my_AUTH_TOKEN'

userAndPass = b64encode(bytes(ACCOUNT_SID + ':' + AUTH_TOKEN, 'utf-8')).decode("ascii")
headers = { 'Authorization' : 'Basic %s' %  userAndPass,
            'Content-type': 'application/x-www-form-urlencoded',
            'Accept': 'text/plain' }

# Update POST parameters accordingly
params = urlencode({
   'From': '19876543212',
   'To': 'client:alice8',
   'Body': 'Test SIP message',
   'StatusCallback': 'http://status.callback.url'
})

conn = HTTPSConnection('mycompany.restcomm.com')
conn.request("POST", '/restcomm/2012-04-24/Accounts/' + ACCOUNT_SID + '/SMS/Messages.json',
      params, headers=headers)
res = conn.getresponse()

// Add your business logic below; status can be found at 'res.status', reason at 'res.reason' and response body can be retrieved with res.read()
...

import java.net.URL;
import javax.net.ssl.HttpsURLConnection;
import java.io.*;
import java.util.Base64;

public class JavaSampleClass {
   // Provide your Account Sid and Auth Token from your Console Account page
   public static final String ACCOUNT_SID = "my_ACCOUNT_SID";
   public static final String AUTH_TOKEN = "my_AUTH_TOKEN";


   public static void main(String[] args) throws Exception {
      String userAndPass = ACCOUNT_SID + ':' + AUTH_TOKEN;
      String encoded = Base64.getEncoder().encodeToString(userAndPass.getBytes());

      URL url = new URL(("https://mycompany.restcomm.com/restcomm/2012-04-24/Accounts/" + ACCOUNT_SID + "/SMS/Messages.json");
      HttpsURLConnection conn = (HttpsURLConnection)url.openConnection();
      conn.setRequestProperty("Authorization", "Basic " + encoded);
      conn.setRequestMethod("POST");
      conn.setDoOutput(true);
      DataOutputStream os = new DataOutputStream(conn.getOutputStream());

      // Update POST parameters accordingly
      os.writeBytes("From=19876543212&" +
        "To=client:alice8&" +
        "Body=Test SIP message&" +
        "StatusCallback=http://status.callback.url");
      os.close();

      // Add your business logic below; response code can be obtained from 'conn.getResponseCode()' and input stream from 'conn.getInputStream()'
      ...
  }
}

Example response:

{
  "sid": "SM0e164269a83c4d5ea331ed83fad5837c",
  "date_created":"Thu, 19 Nov 2015 07:21:35 -0500",
  "date_updated":"Thu, 19 Nov 2015 07:21:35 -0500",
  "account_sid":"ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "from":"19876543212",
  "to":"client:alice",
  "body":"Test SIP message",
  "status":"sending",
  "direction":"outbound-api",
  "price":"0",
  "price_unit":"USD",
  "api_version":"2012-04-24",
  "uri":"/restcomm/2012-04-24/Accounts/<accountSid>/SMS/Messages/SM0e164269a83c4d5ea331ed83fad5837c.json"
}

Get SMS List

GET /restcomm/2012-04-24/Accounts/{accountSid}/SMS/Messages

Returns a list of SMS records corresponding to SMS messages sent or received from the provided AccountSid, subject to the provided paging, filtering and sorting URL query parameters.

Paging

The following paging parameters are supported

Query Parameter	Description
Page	Which page of SMS records to return, starting from 0.
PageSize	Number of records returned per page.

Query Parameter

Description

Page

Which page of SMS records to return, starting from 0.

PageSize

Number of records returned per page.

Filtering

The following filtering parameters are supported

Query Parameter Description

Query Parameter	Description
To	Only show messages addressed to this phone number or Client identifier.
From	Only show messages sent from this phone number or Client identifier.
StartTime	Only show messages that were sent or received on this date/time or later, given as an ISO-8601 date/time string, like `YYYY-MM-DDTHH:MM:SS` (for example `2018-10-05T22:45:32`) or, if you want to omit the time, YYYY-MM-DD (for example `2018-10-05`). When only a date is provided the time is assumed to be at midnight of the given date. Note that the given date/time is inclusive and is assumed to be in UTC timezone.
EndTime	Only show messages that were sent or received on this date/time or earlier, given as an ISO-8601 date/time string, like `YYYY-MM-DDTHH:MM:SS` (for example `2018-10-06T02:10:03`) or, if you want to omit the time, YYYY-MM-DD (for example `2018-10-06`). When only a date is provided the time is assumed to be at midnight of the given date. Note that the given date/time is inclusive and is assumed to be in UTC timezone.
Body	Only show messages that match this body text, partially or fully.

Only show messages addressed to this phone number or Client identifier.

From

Only show messages sent from this phone number or Client identifier.

StartTime

Only show messages that were sent or received on this date/time or later, given as an ISO-8601 date/time string, like YYYY-MM-DDTHH:MM:SS (for example 2018-10-05T22:45:32) or, if you want to omit the time, YYYY-MM-DD (for example 2018-10-05). When only a date is provided the time is assumed to be at midnight of the given date. Note that the given date/time is inclusive and is assumed to be in UTC timezone.

EndTime

Only show messages that were sent or received on this date/time or earlier, given as an ISO-8601 date/time string, like YYYY-MM-DDTHH:MM:SS (for example 2018-10-06T02:10:03) or, if you want to omit the time, YYYY-MM-DD (for example 2018-10-06). When only a date is provided the time is assumed to be at midnight of the given date. Note that the given date/time is inclusive and is assumed to be in UTC timezone.

Body

Only show messages that match this body text, partially or fully.

Sorting Information

Below you can find the supported sorting parameters. In order to use them you need to utilize the SortBy query parameter to determine which attribute you want to sort by and in which direction; direction can either be 'asc' for ascending and 'desc' for descending sort ordering. Here’s the overall format: SortBy=<sorting attribute>:<direction>. If no direction parameter is provided, then the listing of messages is sorted by the attribute in ascending order.

Query Parameter	Description
DateCreated	Sort by date on which the message was sent.
From	Sort by the party who initiated the message.
To	Sort by the party who received the message.
Direction	Sort by the direction of the message.
Status	Sort by the status of the message.
Body	Sort by the text body of the message.
Price	Sort by the price of the message, if applicable.

Query Parameter

Description

DateCreated

Sort by date on which the message was sent.

From

Sort by the party who initiated the message.

Sort by the party who received the message.

Direction

Sort by the direction of the message.

Status

Sort by the status of the message.

Body

Sort by the text body of the message.

Price

Sort by the price of the message, if applicable.

Examples

The command below will return the first page of SMS records corresponding to SMS messages sent from '19876543212' to '13216549878' between 2018-05-30 and 2018-06-09, sorted by the creation date in ascending order:

curl -X GET https://mycompany.restcomm.com/restcomm/2012-04-24/Accounts/ACCOUNT_SID/SMS/Messages.json?From=19876543212&To=13216549878&StartTime=2018-05-30&EndTime=2018-06-09&Page=0&PageSize=10&SortBy=DateCreated:asc \
   -u "YourAccountSid:YourAuthToken"

const request = require('request');

// Provide your Account Sid and Auth Token from your Console Account page
const ACCOUNT_SID = 'my_ACCOUNT_SID';
const AUTH_TOKEN = 'my_AUTH_TOKEN';

request({
      method: 'GET',
      url: 'https://mycompany.restcomm.com/restcomm/2012-04-24/Accounts/' + ACCOUNT_SID + '/SMS/Messages.json?From=19876543212&To=13216549878&StartTime=2018-05-30&EndTime=2018-06-09&Page=0&PageSize=10&SortBy=DateCreated:asc',
      auth: { 'user': ACCOUNT_SID, 'pass': AUTH_TOKEN },
   },
   function (error, response, body) {
      // Add your business logic below; status can be found at 'response.statusCode' and response body at 'body'
      ...
   }
);

from http.client import HTTPSConnection
from base64 import b64encode

# Provide your Account Sid and Auth Token from your Console Account page
ACCOUNT_SID = 'my_ACCOUNT_SID'
AUTH_TOKEN = 'my_AUTH_TOKEN'

userAndPass = b64encode(bytes(ACCOUNT_SID + ':' + AUTH_TOKEN, 'utf-8')).decode("ascii")
headers = { 'Authorization' : 'Basic %s' %  userAndPass }

conn = HTTPSConnection('mycompany.restcomm.com')
conn.request("GET", '/restcomm/2012-04-24/Accounts/' + ACCOUNT_SID + '/SMS/Messages.json?From=19876543212&To=13216549878&StartTime=2018-05-30&EndTime=2018-06-09&Page=0&PageSize=10&SortBy=DateCreated:asc',
      headers=headers)
res = conn.getresponse()

// Add your business logic below; status can be found at 'res.status', reason at 'res.reason' and response body can be retrieved with res.read()
...

import java.net.URL;
import javax.net.ssl.HttpsURLConnection;
import java.io.*;
import java.util.Base64;

public class JavaSampleClass {
   // Provide your Account Sid and Auth Token from your Console Account page
   public static final String ACCOUNT_SID = "my_ACCOUNT_SID";
   public static final String AUTH_TOKEN = "my_AUTH_TOKEN";


   public static void main(String[] args) throws Exception {
      String userAndPass = ACCOUNT_SID + ':' + AUTH_TOKEN;
      String encoded = Base64.getEncoder().encodeToString(userAndPass.getBytes());

      URL url = new URL("https://mycompany.restcomm.com/restcomm/2012-04-24/Accounts/" + ACCOUNT_SID + "/SMS/Messages.json?From=19876543212&To=13216549878&StartTime=2018-05-30&EndTime=2018-06-09&Page=0&PageSize=10&SortBy=DateCreated:asc");
      HttpsURLConnection conn = (HttpsURLConnection)url.openConnection();
      conn.setRequestProperty("Authorization", "Basic " + encoded);
      conn.setRequestMethod("GET");

      // Add your business logic below; response code can be obtained from 'conn.getResponseCode()' and input stream from 'conn.getInputStream()'
      ...
  }
}

Example response:

{
    "page": 0,
    "page_size": 10,
    "total": 2,
    ...
    "messages": [
        {
            "sid": "SM350df10671b64616a3bb92981967cecb",
            "date_created": "Thu, 31 May 2018 16:10:32 +0000",
            "date_updated": "Thu, 31 May 2018 16:10:32 +0000",
            "account_sid": "<accountSid>",
            "from": "19876543212",
            "to": "13216549878",
            "body": "Hello 13216549878",
            "status": "sent",
            "direction": "outbound-api",
            "price": "0.00",
            "price_unit": "USD",
            "api_version": "2012-04-24",
            "uri": "/2012-04-24/Accounts/<accountSid>/SMS/Messages/SM350df10671b64616a3bb92981967cecb.json"
        },
        ...
    ]
}

Get single SMS Information

GET /restcomm/2012-04-24/Accounts/{accountSid}/SMS/Messages/{MessageSid}

Returns detailed information for a single SMS identified by the MessageSid path parameter in the URL.

Examples

Retrieve the information of the SMS record with Sid SM55ce5cf07b9649c283cbacab4dae56a9:

curl -X GET https://mycompany.restcomm.com/restcomm/2012-04-24/Accounts/ACCOUNT_SID/SMS/Messages/MESSAGE_SID.json \
   -u "YourAccountSid:YourAuthToken"

const request = require('request');

// Provide your Account Sid and Auth Token from your Console Account page
const ACCOUNT_SID = 'my_ACCOUNT_SID';
const AUTH_TOKEN = 'my_AUTH_TOKEN';
// Provide additional path parameters if applicable
const MESSAGE_SID = 'my_MESSAGE_SID'

request({
      method: 'GET',
      url: 'https://mycompany.restcomm.com/restcomm/2012-04-24/Accounts/' + ACCOUNT_SID + '/SMS/Messages/' + MESSAGE_SID + '.json',
      auth: { 'user': ACCOUNT_SID, 'pass': AUTH_TOKEN },
   },
   function (error, response, body) {
      // Add your business logic below; status can be found at 'response.statusCode' and response body at 'body'
      ...
   }
);

from http.client import HTTPSConnection
from base64 import b64encode

# Provide your Account Sid and Auth Token from your Console Account page
ACCOUNT_SID = 'my_ACCOUNT_SID'
AUTH_TOKEN = 'my_AUTH_TOKEN'
// Provide additional path parameters if applicable
MESSAGE_SID = 'my_MESSAGE_SID'

userAndPass = b64encode(bytes(ACCOUNT_SID + ':' + AUTH_TOKEN, 'utf-8')).decode("ascii")
headers = { 'Authorization' : 'Basic %s' %  userAndPass }

conn = HTTPSConnection('mycompany.restcomm.com')
conn.request("GET", '/restcomm/2012-04-24/Accounts/' + ACCOUNT_SID + '/SMS/Messages/' + MESSAGE_SID + '.json',
      headers=headers)
res = conn.getresponse()

// Add your business logic below; status can be found at 'res.status', reason at 'res.reason' and response body can be retrieved with res.read()
...

import java.net.URL;
import javax.net.ssl.HttpsURLConnection;
import java.io.*;
import java.util.Base64;

public class JavaSampleClass {
   // Provide your Account Sid and Auth Token from your Console Account page
   public static final String ACCOUNT_SID = "my_ACCOUNT_SID";
   public static final String AUTH_TOKEN = "my_AUTH_TOKEN";
   // Provide additional path parameters if applicable
   public static final String MESSAGE_SID = "my_MESSAGE_SID"

   public static void main(String[] args) throws Exception {
      String userAndPass = ACCOUNT_SID + ':' + AUTH_TOKEN;
      String encoded = Base64.getEncoder().encodeToString(userAndPass.getBytes());

      URL url = new URL("https://mycompany.restcomm.com/restcomm/2012-04-24/Accounts/" + ACCOUNT_SID + "/SMS/Messages/" + MESSAGE_SID + ".json");
      HttpsURLConnection conn = (HttpsURLConnection)url.openConnection();
      conn.setRequestProperty("Authorization", "Basic " + encoded);
      conn.setRequestMethod("GET");

      // Add your business logic below; response code can be obtained from 'conn.getResponseCode()' and input stream from 'conn.getInputStream()'
      ...
  }
}

Example response:

{
  "sid": "SM6c13cca264f940a4b4573a49e8bdf917",
  "date_created": "Thu, 4 Jul 2019 07:02:28 +0000",
  "date_updated": "Thu, 4 Jul 2019 07:02:33 +0000",
  "date_sent": "2019-07-04T07:02:28.000Z",
  "account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "from": "dev-test",
  "to": "4915739360736",
  "body":"Another test from Restcomm",
  "status": "delivered",
  "direction": "outbound-api",
  "num_segments": 1,
  "price": "0",
  "price_unit": "USD",
  "api_version": "2012-04-24",
  "uri": "2012-04-24/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/SMS/Messages/SM6c13cca264f940a4b4573a49e8bdf917.json"
}

SMS Attributes

The attributes of the SMS resource are as follows:

Attribute Description

Attribute	Description
Sid	A string that uniquely identifies the SMS Message.
DateCreated	The date on which this SMS Message was created.
DateUpdated	The date on which this SMS Message was last updated.
DateSent	The date on which the SMS was sent or received by Restcomm.
AccountSid	The AccountSid that sent or received this SMS message.
From	The phone number or short code that sent the message.
To	The phone number, short code or client that received the message.
Body	The text body of the SMS message.
Status	The status of this SMS message. Possible values are `queued`, `sending`, `sent`, `failed`, `received`, `delivered` and `undelivered`. For more information on the statuses please refer to 'Status Description' section
Direction	The direction of this SMS message. Possible values are `incoming`, `outbound-api`, `outbound-call`.
ApiVersion	The API version Restcomm used to handle the SMS message.
Uri	The suffix for the HTTP resource, relative to the base organization url. For example when creating an SMS message using the endpoint \<<, the Uri will be `/2012-04-24/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/SMS/Messages/SM03dd468462814f20a28ea7be4cffac29.json`
error_code	Provides more information about failure reason in case message status is failed or undelivered. If not, it will be null.
error_message	Similar to error_code, but providing human readable text.
num_segments	If the message is sent to PSTN and requires segmentation because of length, this will indicate number of segments. This is not available in POST response.

Sid

A string that uniquely identifies the SMS Message.

DateCreated

The date on which this SMS Message was created.

DateUpdated

The date on which this SMS Message was last updated.

DateSent

The date on which the SMS was sent or received by Restcomm.

AccountSid

The AccountSid that sent or received this SMS message.

From

The phone number or short code that sent the message.

The phone number, short code or client that received the message.

Body

The text body of the SMS message.

Status

The status of this SMS message. Possible values are queued, sending, sent, failed, received, delivered and undelivered. For more information on the statuses please refer to 'Status Description' section

Direction

The direction of this SMS message. Possible values are incoming, outbound-api, outbound-call.

ApiVersion

The API version Restcomm used to handle the SMS message.

Uri

The suffix for the HTTP resource, relative to the base organization url. For example when creating an SMS message using the endpoint \<<, the Uri will be /2012-04-24/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/SMS/Messages/SM03dd468462814f20a28ea7be4cffac29.json

error_code

Provides more information about failure reason in case message status is failed or undelivered. If not, it will be null.

error_message

Similar to error_code, but providing human readable text.

num_segments

If the message is sent to PSTN and requires segmentation because of length, this will indicate number of segments. This is not available in POST response.

Status Description

Here is a detailed breakdown of the Status attribute describing the current status of the SMS message:

Status	Description
queued	Restcomm has queued the message pending transmission. Applies to outbound messages.
sending	Restcomm has accepted the message and is sending it to the provider. Applies to outbound messages.
sent	Restcomm has already sent the message to the provider. Applies to outbound messages.
failed	Message failed processing either on the Restcomm or provider’s side. The reason could be that the message was expired, rejected or deleted by the provider.
received	Restcomm has received the message. Applies to inbound message.
delivered	The provider has delivered the message into user’s terminal. Applies to outbound messages.
undelivered	The provider couldn’t deliver the message to the user’s SMS endpoint. Applies to outbound messages.

Status

Description

queued

Restcomm has queued the message pending transmission. Applies to outbound messages.

sending

Restcomm has accepted the message and is sending it to the provider. Applies to outbound messages.

sent

Restcomm has already sent the message to the provider. Applies to outbound messages.

failed

Message failed processing either on the Restcomm or provider’s side. The reason could be that the message was expired, rejected or deleted by the provider.

received

Restcomm has received the message. Applies to inbound message.

delivered

The provider has delivered the message into user’s terminal. Applies to outbound messages.

undelivered

The provider couldn’t deliver the message to the user’s SMS endpoint. Applies to outbound messages.

SMS-specific error codes

In cases where an SMS fails to be delivered due to a Provider-related error

Code	Message
30001	Queue overflow
30002	Account suspended
30003	Unreachable destination handset
30004	Message blocked
30005	Unknown destination handset
30006	Landline or unreachable carrier
30007	Carrier violation
30008	Unknown error
30009	Missing segment
300010	Message price exceeds max price