Fetch All SMS API with Mobile Number

The Fetch All SMS API with Mobile Number API accepts the mobile number as an input parameter and fetches all the SMS message details.

URL

The HTTP URL for Fetch All SMS API with Mobile Number API is:

http://<host or ip>:<port>/api/v1/messages/sms/fetch

Note: Fetch All SMS API with Audience ID API does not require authentication. It is not a secure API

Method

POST

Header

The payload's request header includes Content-Type as application/json;charset=UTF-8.

Input Parameters

The following fields are input parameters:

Input Parameter	Required	Type	Description
mobileNo	Yes	long	Mobile number of an audience member
startElement	Optional	long	Start index of the element
elementsPerPage	Optional	long	Number of elements for a page

Sample Request

{"startElement": "0", "elementsPerPage": "10","mobileNo": "+919994545435"}

Output Parameters

The following fields are output parameters:

Output Parameter	Level-Two	Type	Description
totalMessages		long	Total number of SMS messages
openedMessages		long	Total number of opened SMS messages
messages			An array of messages objects as submitted or cancelled
	fetchId	long	Unique ID assigned to a SMS message
	content	string	SMS message text or SMS Voice message
	status	string	Current SMS message status as
submittedMessages		long	Total number of submitted SMS messages

Sample Response

{
  "totalMessages": 4,
  "openedMessages": 0,
  "messages": [
    {
      "fetchId": "6787084818838978497",
      "content": "LathaGanesh",
      "status": "Submitted"
    },
    {
      "fetchId": "6790833484766511073",
      "content": "Latha",
      "status": "Submitted"
    },
    {
      "fetchId": "6790832870844132846",
      "content": " Latha Ganesh eBay summer sale 2016",
      "status": "Submitted"
    },
    {
      "fetchId": "6790758891557814220",
      "content": "Latha Ganesh eBay summer sale 2016",
      "status": "Submitted"
    }
  ],
  "submittedMessages": 4
}

Response Status

Code	Description
Status 200	SMS details
Status 400	Audience ID and mobile number are missing. One of them is needed to process the requestNo valid audience found with the given Mobile Number
Status 401	Unauthorized request
Status 500	Server failure to process request