WhatsApp Sent Message Listing
Base URL
https://graph.communikate.inAuthentication
All API requests require authentication credentials. Include your API Key and API Secret in request headers to access protected endpoints.
Every API endpoint requires the following headers.
X-Api-Key
Your public API key.
X-Api-Secret
Your secret API key.
POST
/meta/wa/reports/msg/get-sent-list
Request Parameters
|
pageNo *
int
|
The page number you want to list. Any invalid number will be rejected and assigned to 1.
|
|
pageSize *
int
|
The number or records you want to retrieve in each page.
The valid values are: 50, 75, 100, 125 & 150.
Any invalid value will be rejected and assigned to 50.
|
|
dateRangeType
int?
|
(OPTIONAL). It sends a signal to server to apply predefined date filter crieteria.
Any invalid or null value be rejected and assigned to value 0.
The valid values are:
If you specify 99 then you will have to specify the value either
for fromDate or both fromDate
and toDate date.
If you specify only from then the system will treat as a single date.
|
|
fromDate
date?
|
(CONDITIONAL OPTIONAL) The date from which you want to filter the data.
The value in this parameter must be specified if the value in parameter dateRangeType is equal to 99.
|
|
toDate
date?
|
(CONDITIONAL OPTIONAL) The date to which you want to filter the data.
|
|
recipientMobileNumber
string?
|
(OPTIONAL) The recipient whatsapp number for which you want to search the data.
|
|
recipientMobileComparisonType
int?
|
(OPTIONAL) A flag which facilitates how to search your specified recipient whatsapp number.
Any invalid or null value will be rejected and assigned to 1.
The valid values are:
|
Response
|
isSuccess
boolean
|
true: success
false: failed |
|
message
string
|
response messae from API endpoint
|
|
traceId
string?
|
a server specific tracing code by which the actual error can be reviewed
|
|
result
string?
|
if isSuccess: true then it contains the result object.
|
Result object explanation:
The result object contains the following objects:
-
sender{}
- businessName:
- The name of the business from which the message was sent
- whatsAppDisplayName:
- The sender WhatsAppName with WhatsAapp Mobile Number.
- whatsAppName:
- The name of the business owner's WhatsApp which was set either by using WhatsApp Business App or by Meta WhatsApp Manager
- whatsAppNumber:
- Meta approved business owenr's WhatsApp Number.
- metaBusinessId:
- Meta provided unique identification number for business owenr's Business Portfolio
- metaWabaId:
- Meta provided unique identification number for business owner's WhatsApp Business Account
- metaPhoneNumberId:
- Meta provided unique identification number for business owner's each phone number registered with the WhatsApp Business Api
- sainofyLockerId:
- Sainofy provided unique identification number for business owner's each locker registered with Sainofy Cloud Messaging Api. This id is very helpful to resolve any issue arises during the operation execution.
- sainofyLockerName:
- The name of the locker associated with sainofyLockerId
- sainofyAssetId:
- Sainofy provided unique identification number for business owner's each WhatsApp number registered with Sainofy Cloud Messaging Api. This id is very helpful to resolve any issue arises during the operation execution.
- sainofyClientApiId:
- Sainofy provided unique identification number for business owner's client based api allocated to use Sainofy Cloud Messaging Api. This id is directly associated with metaPhoneNumberId and mainly responsible to retrieve data from Sainofy Cloud Messaging Server. This id is very-very helpful to resolve any issue arises during the operation execution.
- sainofyClientApiName:
- The name of the locker associated with sainofyClientApiId
- sainofyClientApiPhoneId:
- Sainofy provided unique identification number for business owner's each phone number registered with the Sainofy Cloud Messaging Api
-
summary{}
- pageTitle:
- The server generated title for the reporting page.
- pageNo:
- User requested page number of the data set.
- pageSize:
- User requested page size of the data set. This instructs the server that how many records should be returned in a each page number.
- totalRecords:
-
The total number of records which are available on the server after applying
your requested filter criteria.
Note: For filter criteria please refer to the section request parameters in this page.
- pageCount:
-
This reflects that how many pages are available which has been already satisfied
the user's data filter criteria.
It helps developers to design and deploy pagination algorithm in his/her consumable environment.
-
nullablemessageLogs[]It contains an array of object but it may be null if there is no record available to satisfy user's filter criteria.
- id:
- Sainofy generated unique identification number of a particular message.
- metaMessageId:
- WhatsApp generated unique identification number of a particular message.
- recipientNumber:
- The receiver's or recipient's WhatsApp number who will receive the message in the WhatsApp chat box.
- messageType:
- It holds the information about which kind of message it was either TEMPLATE based or NON-TEMPLATE based.
- direction:
- It will hold only-and-only OUT value in this api endpoint.
- status:
-
It holds one the four values:
- SENT
- It means the message was received by the WhatsApp Server, but still needs to be delivered to the recipient.
- FAILED
- Means, the WhatsApp has rejected the message and an error message with code is logged in lastError. You can review your error code in Facebook Official Error Docs
- DELIVERED
- The message has arrived in the recipient WhatsApp Chat Box, but has not yet been read by the him/her.
- READ
- And, finally the message was read by the recipient and there is no pending regarding this metaMessageId
- sentOnUtc:
- UTC based date and time on which the message was sent.
- sentOnIst:
- Indian Standard Time based date and time on which the message was sent.
- deliveredOnUtc?:
- (nullable) UTC based date and time on which the message was delivered to the recipient's WhatsApp Chat Box.
- deliveredOnIst?:
- (nullable) Indian Standard Time based date and time on which the message was delivered to the recipient's WhatsApp Chat Box.
- readOnUtc?:
- (nullable) UTC based date and time on which the message was read by the recipient.
- readOnIst?:
- (nullable) Indian Standard Time based date and time on which the message was read by the recipient.
- lastError?:
- (nullable) When status = FAILED, it holds an error code with error message, otherwise it holds null value. Facebook Official Error Docs
cURL Request
curl 'https://graph.communikate.in/meta/wa/reports/msg/get-sent-list' \
--header 'X-Api-Key: YOUR_API_KEY' \
--header 'X-Api-Secret: YOUR_API_SECRET' \
--header 'Content-Type: application/json' \
--payload '{
"pageNo": 1,
"pageSize": 50,
"dateRangeType": 1,
"fromDate": "2026-08-01T00:00:00",
"toDate": "2026-08-02T23:59:59",
"recipientMobileNumber": "919876543210",
"recipientMobileComparisonType": 0
}'
Json Response
{
"isSuccess": true,
"message": "50 record(s) fetched successfully.",
"traceId": null,
"result": {
"sender": {
"businessName": "SAINOFY INFOSYSTEMS",
"whatsAppDisplayName": "Sainofy Mumbai (+91 xxxxx xxxxx)",
"whatsAppName": "Sainofy Mumbai Branch",
"whatsAppNumber": "+91xxxxxxxxxx",
"metaBusinessId": "3656xxxxxxxxxxx",
"metaWabaId": "1147xxxxxxxxxxxx",
"metaPhoneNumberId": "9066xxxxxxxxxxx",
"sainofyLockerId": "8082xxxxxxxxxxx",
"sainofyLockerName": "Mumabi-Branch",
"sainofyAssetId": "2664xxxxxxxxxxx",
"sainofyClientApiId": "0104AC07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"sainofyClientApiName": "zoho crm",
"sainofyClientApiPhoneId": "5132xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
},
"summary": {
"pageTitle": "Page 1 of 80 - OUT Message - For All Dates.",
"pageNo": 1,
"pageSize": 50,
"totalRecords": 3971,
"pageCount": 80
},
"messageLogs": [
{
"id": "zde67f22-xxxx-xxxx-xxxx-cc41dac0a22a",
"metaMessageId": "wamid.xxxxxx",
"recipientNumber": "95xxxxxxxx",
"messageType": "TEMPLATE",
"direction": "OUT",
"status": "SENT",
"sentOnUtc": "2026-04-16T14:12:23.1173315",
"sentOnIst": "2026-04-16T19:42:23.1173315",
"deliveredOnUtc": null,
"deliveredOnIst": null,
"readOnUtc": null,
"readOnIst": null,
"lastError": null
},
{
"id": "a9d67e18-xxxx-xxxx-xxxx-9dde61b06d7e",
"metaMessageId": "wamid.xxxxxx",
"recipientNumber": "94xxxxxxxx",
"messageType": "TEMPLATE",
"direction": "OUT",
"status": "FAILED",
"sentOnUtc": "2026-04-16T14:12:23.1173315",
"sentOnIst": "2026-04-16T19:42:23.1173315",
"deliveredOnUtc": null,
"deliveredOnIst": null,
"readOnUtc": null,
"readOnIst": null,
"lastError": "131026 - Message undeliverable"
},
{
"id": "261b6cf4-156d-4e30-b0b7-bb41dac0a11a",
"metaMessageId": "wamid.xxxxxx",
"recipientNumber": "80xxxxxxxx",
"messageType": "TEMPLATE",
"direction": "OUT",
"status": "DELIVERED",
"sentOnUtc": "2026-04-16T14:11:36.9514709",
"sentOnIst": "2026-04-16T19:41:36.9514709",
"deliveredOnUtc": "2026-04-16T14:12:32.027577",
"deliveredOnIst": "2026-04-16T19:41:45.6226239",
"readOnUtc": null,
"readOnIst": null,
"lastError": null
},
{
"id": "ccfd1d5c-808e-4d16-aa0b-2e2de8f636b5",
"metaMessageId": "wamid.xxxxxx",
"recipientNumber": "99xxxxxxxx",
"messageType": "TEMPLATE",
"direction": "OUT",
"status": "READ",
"sentOnUtc": "2026-04-16T14:10:29.013787",
"sentOnIst": "2026-04-16T19:40:29.013787",
"deliveredOnUtc": "2026-04-16T14:10:37.2445714",
"deliveredOnIst": "2026-04-16T19:40:37.2445714",
"readOnUtc": "2026-04-16T14:10:55.2445736",
"readOnIst": "2026-04-16T19:40:55.2445736",
"lastError": null
}
]
}
}