GET /api/analytics/templates Returns notification metrics broken down by template, including time series data for each template.

Headers

appid
string
required
Your CometChat App ID.
apikey
string
required
Your CometChat API Key.

Query parameters

from
string
required
Start date in ISO 8601 format.
to
string
required
End date in ISO 8601 format.
granularity
string
default:"daily"
Time series granularity: hourly or daily.

Example request

curl "https://{appId}.api-{region}.cometchat.io/v3/business-messaging/api/analytics/templates?from=2024-01-01T00:00:00Z&to=2024-01-31T23:59:59Z&granularity=daily" \
  -H "appid: YOUR_APP_ID" \
  -H "apikey: YOUR_API_KEY"

Example response

[
  {
    "templateId": "665b2c3d4e5f6a7b8c9d0e1f",
    "templateName": "Order Confirmation",
    "delivered": 8000,
    "viewed": 4500,
    "clicked": 1800,
    "timeSeries": [
      {
        "date": "2024-01-01",
        "delivered": 260,
        "viewed": 150,
        "clicked": 60
      }
    ]
  }
]

Response fields

templateId
string
Template identifier.
templateName
string
Template display name.
delivered
integer
Total delivered count for this template.
viewed
integer
Total viewed count for this template.
clicked
integer
Total clicked count for this template.
timeSeries
object[]
Array of time-bucketed data points with date, delivered, viewed, and clicked.