Delivery and Seen Reports

Discover in which way you can get real-time reports about the messages you have sent.

Get Delivery Reports

Once you’ve successfully sent your message, you can check the status of sent messages using the OMNI reports method. 

The simplest way is to use the method without any query parameters. In that case, the response will contain all messages sent to a specific account. 

GET /omni/1/reports HTTP/1.1 
Host: api.infobip.com
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ== 
Accept: application/json	
  

The response will contain all messages, rejected and delivered, as shown in the example below. 

HTTP/1.1 200 OK 
Content-Type: application/json 
 
{
    "results": [
        {
            "messageId": "1215f543ab19-345f-adbd-12ad31451ed25f35",
            "to": "41793026731",
            "sentAt": "2018-12-12T11:21:57.793+0000",
            "doneAt": "2018-12-12T11:21:58.771+0000",
            "messageCount": 1,
            "mccMnc": "null",
            "price": {
                "pricePerMessage": 0,
                "currency": "EUR"
            },
            "status": {
                "groupId": 3,
                "groupName": "DELIVERED",
                "id": 5,
                "name": "DELIVERED_TO_HANDSET",
                "description": "Message delivered to handset"
            },
            "error": {
                "groupId": 0,
                "groupName": "OK",
                "id": 0,
                "name": "NO_ERROR",
                "description": "No Error",
                "permanent": false
            },
            "channel": "WHATSAPP"
        }
    ]
}	
  

For complete list of all error codes and statuses, please refer to the following link: Response Codes and Error Codes 

NOTE

You can also have delivery reports forwarded to your URL in real-time. In that case, you should provide URL to your account manager and they will set it up for you.

Receive WhatsApp Seen Reports  

Seen reports are always forwarded to the URL client previously provides to Infobip.

Seen report  

{
    "results": [
        {
            "messageId": "1215f543ab19-345f-adbd-12ad31451ed25f35",
            "to": "41793026731",
            "sentAt": "2018-12-12T11:21:57.793+0000",
            "seenAt": "2018-12-12T11:21:58.251+0000"
        }
    ]
}