Status query request message

With the Push Plus level of service, you can request information about the status of a push message. The status isn't available with the Push Essentials level of service.

A push message is identified by its push ID. To receive the delivery status of the push message to certain BlackBerry devices, you need to specify their PINs or tokens as addresses. If you don't specify the PINs or tokens, the system returns information about every device that was sent the message with that push ID.

After the PPG receives the status query request message, it sends the Push Initiator a status query response message. The PPG only keeps the status of a push message for a limited time (for example, 48 hours) after the push message was sent.

Here's an example of a status query request.

<?xml version="1.0"?>
<!DOCTYPE pap PUBLIC "-//WAPFORUM//DTD PAP 2.1//EN" 
"http://www.openmobilealliance.org/tech/DTD/pap_2.1.dtd">
<pap>
  <statusquery-message push-id="999999999">
  </statusquery-message>
</pap>

And here's an example of the status query response that the PPG sends for the query request.

<?xml version="1.0"?>
<!DOCTYPE pap PUBLIC "-//WAPFORUM//DTD PAP 2.1//EN"
"http://www.openmobilealliance.org/tech/DTD/pap_2.1.dtd">
<pap>
<statusquery-response push-id="999999999">
<statusquery-result event-time="2013-09-31T13:00:00Z" message-state="delivered" code="1000" desc="The request succeeded.">
	<address address-value="PIN00001"/>
	<quality-of-service delivery-method="confirmed"/>
</statusquery-result>
<statusquery-result event-time="2013-09-31T13:00:00Z" message-state="delivered" code="1001" desc="The request has been accepted for processing.">
	<address address-value="PIN00002"/>
	<quality-of-service delivery-method="confirmed"/>
</statusquery-result>
<statusquery-result event-time="2013-09-31T13:00:00Z" message-state="delivered" code="4500" desc="The request failed because the message expired before it could be delivered.">
	<address address-value="PIN00003"/>
	<quality-of-service delivery-method="confirmed"/>
</statusquery-result>
</statusquery-response></pap>