GET api/v1/reports/messages/{messageId}/responses?filter.User={filter.User}&filter.Status={filter.Status}&filter.StartDate={filter.StartDate}&filter.EndDate={filter.EndDate}&filter.Range={filter.Range}&filter.Destination={filter.Destination}&filter.Reference={filter.Reference}&paging.Page={paging.Page}&paging.NoOfRecords={paging.NoOfRecords}&sort.Field={sort.Field}&sort.AscendingDescending={sort.AscendingDescending}

Retrieves all the recipients that have responded to the message. It will also display whether there are any unread responses.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
messageId

The ID of the message.

globally unique identifier

Required

User

By user who responded to the response from the recipient.

globally unique identifier

None.

Status

By responses that have been read or unread or both.

StatusResponse

None.

StartDate

The date for the records to start from. The format is the following:[YYYY-MM-DDTHH:MM:SSZ]

date

None.

EndDate

The date for the records to finish. The format is the following:[YYYY-MM-DDTHH:MM:SSZ]

date

None.

Range

Date ranges to search records for.

DateRange

None.

Destination

To search for a particular Short Code

string

None.

Reference

To search for a Reference

string

None.

Page

The Page number for the report.

integer

Required

NoOfRecords

The number of records to return per page.

integer

Required

Field

The field to sort the records by.

SortField

None.

AscendingDescending

Determines whether to sort the records in ascending or descending order.

boolean

None.

Body Parameters

None.

Response Information

Resource Description

ResponseOfListOfMessageResponseSummary
NameDescriptionTypeAdditional information
Error

Error

None.

ResponseData

ResponseDataOfListOfMessageResponseSummary

None.

Response Formats

application/json, text/json

Sample:
{
  "Error": {
    "ErrorCode": "sample string 1",
    "ErrorReason": "sample string 2"
  },
  "ResponseData": {
    "Identification": {
      "UserId": "sample string 1"
    },
    "Result": "sample string 1",
    "Detail": [
      {
        "From": "sample string 1",
        "ID": "384494b9-c48d-4c0c-a379-e66fee1fd2a6",
        "LatestMessageReceived": "2024-03-28T22:08:10.4239921+00:00",
        "MessageID": "e3d11ca5-c4ac-48ea-82fa-462daad831d4",
        "NoOfResponses": 4,
        "UnreadResponses": true,
        "Recipient": "sample string 6"
      },
      {
        "From": "sample string 1",
        "ID": "384494b9-c48d-4c0c-a379-e66fee1fd2a6",
        "LatestMessageReceived": "2024-03-28T22:08:10.4239921+00:00",
        "MessageID": "e3d11ca5-c4ac-48ea-82fa-462daad831d4",
        "NoOfResponses": 4,
        "UnreadResponses": true,
        "Recipient": "sample string 6"
      }
    ]
  }
}

application/xml, text/xml

Sample:
<ResponseOfListOfMessageResponseSummary xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Error>
    <ErrorCode>sample string 1</ErrorCode>
    <ErrorReason>sample string 2</ErrorReason>
  </Error>
  <ResponseData>
    <Result>sample string 1</Result>
    <Identification>
      <UserId>sample string 1</UserId>
    </Identification>
    <Detail>
      <MessageResponseSummary>
        <From>sample string 1</From>
        <ID>384494b9-c48d-4c0c-a379-e66fee1fd2a6</ID>
        <LatestMessageReceived>2024-03-28T22:08:10.4239921+00:00</LatestMessageReceived>
        <MessageID>e3d11ca5-c4ac-48ea-82fa-462daad831d4</MessageID>
        <NoOfResponses>4</NoOfResponses>
        <UnreadResponses>true</UnreadResponses>
        <Recipient>sample string 6</Recipient>
      </MessageResponseSummary>
      <MessageResponseSummary>
        <From>sample string 1</From>
        <ID>384494b9-c48d-4c0c-a379-e66fee1fd2a6</ID>
        <LatestMessageReceived>2024-03-28T22:08:10.4239921+00:00</LatestMessageReceived>
        <MessageID>e3d11ca5-c4ac-48ea-82fa-462daad831d4</MessageID>
        <NoOfResponses>4</NoOfResponses>
        <UnreadResponses>true</UnreadResponses>
        <Recipient>sample string 6</Recipient>
      </MessageResponseSummary>
    </Detail>
  </ResponseData>
</ResponseOfListOfMessageResponseSummary>