GET api/v1/reports/messages/pendingandrecurring?filter.Range={filter.Range}&filter.RecentDays={filter.RecentDays}&filter.Reference={filter.Reference}&filter.ReportType={filter.ReportType}&filter.SoftwareVersion={filter.SoftwareVersion}&filter.DestinationName={filter.DestinationName}&filter.StartDate={filter.StartDate}&filter.EndDate={filter.EndDate}&filter.Destination={filter.Destination}&paging.ReportID={paging.ReportID}&paging.Page={paging.Page}&paging.NoOfRecords={paging.NoOfRecords}

Retrieves all messages that are scheduled or all recurring messages setup on the account. Paging and filtering can be applied.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
Range

Date ranges to search records for.

 FutureDateRange

None.
RecentDays

Return the last x number of days traffic. Max. 14

 integer

None.
Reference

Return all messages that have a given reference.

 string

None.
ReportType

The type of the messages to be returned.

 ReportType

None.
DestinationName

Contact name linked with a destination

 string

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.
ReportID

The ID of the report.

 string

None.
Page

The Page number for the report.

 integer

Required
NoOfRecords

The number of records to return per page.

 integer

Required

Body Parameters

None.

Response Information

Resource Description

ResponseOfReportPendingAndRecurringResponseData
NameDescriptionTypeAdditional information
Error

Error

None.
ResponseData

ResponseDataOfReportPendingAndRecurringResponseData

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": {
      "PendingMessages": [
        {
          "ID": "sample string 1",
          "Status": "sample string 2",
          "DateSubmitted": "2026-06-18T05:33:39.3224338+00:00",
          "DateSent": "2026-06-18T05:33:39.3224338+00:00",
          "Text": "sample string 5",
          "Destination": "sample string 6",
          "ContactDestination": "sample string 7",
          "GUID": "sample string 8"
        },
        {
          "ID": "sample string 1",
          "Status": "sample string 2",
          "DateSubmitted": "2026-06-18T05:33:39.3224338+00:00",
          "DateSent": "2026-06-18T05:33:39.3224338+00:00",
          "Text": "sample string 5",
          "Destination": "sample string 6",
          "ContactDestination": "sample string 7",
          "GUID": "sample string 8"
        }
      ],
      "RecurringMessages": [
        {
          "ID": "sample string 1",
          "Text": "sample string 2",
          "Destination": "sample string 3",
          "ContactDestination": "sample string 4",
          "DaysToSend": "sample string 5",
          "TimeToSend": "2026-06-18T05:33:39.3234347+00:00",
          "GUID": "sample string 7",
          "RecurrencesRemaining": 8
        },
        {
          "ID": "sample string 1",
          "Text": "sample string 2",
          "Destination": "sample string 3",
          "ContactDestination": "sample string 4",
          "DaysToSend": "sample string 5",
          "TimeToSend": "2026-06-18T05:33:39.3234347+00:00",
          "GUID": "sample string 7",
          "RecurrencesRemaining": 8
        }
      ],
      "ReportTitle": "sample string 1",
      "ReportID": "sample string 2",
      "ItemsPerPage": "sample string 3",
      "Page": "sample string 4",
      "TotalItems": "sample string 5"
    }
  }
}

application/xml, text/xml

Sample: 
<ResponseOfReportPendingAndRecurringResponseData 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>
      <PendingMessages>
        <PendingReportMessage>
          <ID>sample string 1</ID>
          <Status>sample string 2</Status>
          <DateSubmitted>2026-06-18T05:33:39.3224338+00:00</DateSubmitted>
          <DateSent>2026-06-18T05:33:39.3224338+00:00</DateSent>
          <Text>sample string 5</Text>
          <Destination>sample string 6</Destination>
          <ContactDestination>sample string 7</ContactDestination>
          <GUID>sample string 8</GUID>
        </PendingReportMessage>
        <PendingReportMessage>
          <ID>sample string 1</ID>
          <Status>sample string 2</Status>
          <DateSubmitted>2026-06-18T05:33:39.3224338+00:00</DateSubmitted>
          <DateSent>2026-06-18T05:33:39.3224338+00:00</DateSent>
          <Text>sample string 5</Text>
          <Destination>sample string 6</Destination>
          <ContactDestination>sample string 7</ContactDestination>
          <GUID>sample string 8</GUID>
        </PendingReportMessage>
      </PendingMessages>
      <RecurringMessages>
        <RecurringReportMessage>
          <ID>sample string 1</ID>
          <Text>sample string 2</Text>
          <Destination>sample string 3</Destination>
          <ContactDestination>sample string 4</ContactDestination>
          <DaysToSend>sample string 5</DaysToSend>
          <TimeToSend>2026-06-18T05:33:39.3234347+00:00</TimeToSend>
          <GUID>sample string 7</GUID>
          <RecurrencesRemaining>8</RecurrencesRemaining>
        </RecurringReportMessage>
        <RecurringReportMessage>
          <ID>sample string 1</ID>
          <Text>sample string 2</Text>
          <Destination>sample string 3</Destination>
          <ContactDestination>sample string 4</ContactDestination>
          <DaysToSend>sample string 5</DaysToSend>
          <TimeToSend>2026-06-18T05:33:39.3234347+00:00</TimeToSend>
          <GUID>sample string 7</GUID>
          <RecurrencesRemaining>8</RecurrencesRemaining>
        </RecurringReportMessage>
      </RecurringMessages>
      <ReportTitle>sample string 1</ReportTitle>
      <ReportID>sample string 2</ReportID>
      <ItemsPerPage>sample string 3</ItemsPerPage>
      <Page>sample string 4</Page>
      <TotalItems>sample string 5</TotalItems>
    </Detail>
  </ResponseData>
</ResponseOfReportPendingAndRecurringResponseData>