Skip to content

Get Message Status

Backendless processes push notification delivery asynchronously. Even when the client app uses blocking/synchronous API, the server creates a push notification delivery task and adds to a queue. Server assigns an ID to the task and returns it to the client as messageId. As a result, push notification delivery status is not available right away. To retrieve the status, the client application must make a separate API call documented below:

Backendless.Messaging.getMessageStatus( messageId )
 .then( function( status ) {
 .catch( function( error ) {


messageId-  ID of the message assigned to the message and returned by the Message Publishing API request.

Return Value

Method returns a JS object with the following structure:



<messageId>- ID of the message for which the publishing status is retrieved.

<status>- can be one of the following "published", "scheduled" or "failed".

<errorMessage>- contains detailed error message when status is "failed".