REST

URL: /services/rest/user/unread-messages

Works for POST and application/x-www-form-urlencoded parameters, or GET and query parameters

Parameters:

name	value	description
username	john	name of the user, parameter is required
password	secret	password, parameter is required

Response is in JSON. Example response:

{
    "newestMessageTimestamp": 1391763319,
    "hasMoreMessages": false,
    "messages": [
        {
            "documentId": "52f49f70e4b019b93a68514d",
            "text": "inbound 1",
            "timestamp": 1391763312,
            "recipient": "defaultvn",
            "from": "71999999999",
            "originDocumentId": "52f49f6ee4b05908950f1ab6"
        },
        {
            "documentId": "52f49f77e4b0924871c585df",
            "text": "inbound 2",
            "timestamp": 1391763319,
            "recipient": "defaultvn",
            "from": "71999999999",
            "originDocumentId": "52f49f75e4b0bf39c293e946"
        }
    ],
    "status": 0
}

Parameters of the response are the same as in Check messages

WebService

Using WebService endpoint user is also able to retrieve unread incoming messages.

WS endpoint: https://mc5.smartmessagingservices.net/services/ws/message?wsdl (method: getUnreadMessages)

Example request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.server.submission.mc5.smspl.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:getUnreadMessages>
         <username>john</username>
         <password>secret</password>
      </ws:getUnreadMessages>
   </soapenv:Body>
</soapenv:Envelope>

Example response:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body>
      <ns1:getUnreadMessagesResponse xmlns:ns1="http://ws.server.submission.mc5.smspl.com/">
         <return>
            <newestMessageTimestamp>1379330433</newestMessageTimestamp>
            <hasMoreMessages>false</hasMoreMessages>
            <messages>
               <documentId>5236e981e4b079d80a314e03</documentId>
               <from>123123123</from>
               <recipient>defaultvn</recipient>
               <text>Text message Ok reply</text>
               <timestamp>1379330433</timestamp>
               <originDocumentId>5236e97ee4b038c375314024</originDocumentId>
            </messages>
            <status>0</status>
         </return>
      </ns1:getUnreadMessagesResponse>
   </soap:Body>
</soap:Envelope>

Status: query status is always returned. Status values and their meaning is explained in the User and Reseller REST API Response Status Codes

Browser not supported