FindDeviceNotifications

Returns a list of Device notifications that entered a specific state during a specified time range.

Sample SOAP Request

Request Parameters

Name

Description

Type

Optional

searchParameters

List of parameters specifying the notifications to return; supported search parameters are:

  • startDate: earliest date and time of the notifications to include in the search results, specified in the following format (GMT):

dd/mm/yyyy h:mm:ss AM/PM

  • endDate: latest date and time of the notifications to include in the search results, specified in the following format (GMT):

dd/mm/yyyy h:mm:ss AM/PM

  • state: comma delimited list of states; supported values are: NOTIFYING, DELIVERED, DEVICE_DELIVERED, DEVICE_READ, RESPONDED, FAILED, and CANCELLED.

list

no

Sample SOAP Response

Response Parameters

Name

Description

Type

deviceNotificationList

List of Device notifications matching the specified search criteria. Each notification returned includes the following details:

  • deviceNotificationId: Device notification identifier
  • personNotificationId: User notification identifier
  • targetName: target name of the Device's owner
  • deviceName: name of the target Device.
  • eventIdentifier: event ID of the notification's associated event
  • status: current status of the notification
  • notificationTimestamp: time at which notification entered the above status.

list

serverTimestamp

Time corresponding to the server time when the request was made (this should match the associated persisted audit event)

string

status

Final status of the request

string

Standard SOAP Parameters

SOAP Response Status Messages