---
title: "Fetch message analytics"
method: GET
path: "/analytics/messages"
tags: ["Messages"]
---

# Fetch message analytics

`GET /analytics/messages`

Returns engagement analytics for multiple messages. Request body specifies message IDs. Each result includes message_id and the analytics object with nullable ISO-8601 timestamps for each engagement event. Missing or inaccessible message IDs are omitted from results.

## Query parameters

- `message_ids` string[], required

## Response `200`

OK

- MessageAnalyticsResponseDTO
  - `url` string — The URL of the analytics resource
  - `results` MessageAnalyticsResultDTO[] — The analytics results for the requested messages
    - `sending_attempted` MessageAnalyticsTimestampDTO
      - `timestamp` string, date-time, nullable — The timestamp of the analytics event
    - `delivered` MessageAnalyticsTimestampDTO
      - `timestamp` string, date-time, nullable — The timestamp of the analytics event
    - `failed` MessageAnalyticsTimestampDTO
      - `timestamp` string, date-time, nullable — The timestamp of the analytics event
    - `read` MessageAnalyticsTimestampDTO
      - `timestamp` string, date-time, nullable — The timestamp of the analytics event
    - `clicked` MessageAnalyticsClickedDTO
      - `applicable` boolean — Whether click analytics apply to this message
      - `buttons` MessageAnalyticsButtonClickDTO[] — The button click events recorded for the message
        - `type` string — The type of clicked button
        - `label` string — The label of the clicked button
        - `timestamp` string, date-time
    - `freeform_replied` MessageAnalyticsTimestampDTO
      - `timestamp` string, date-time, nullable — The timestamp of the analytics event
    - `message_id` string — The ID of the analyzed message

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/superchat/apis/superchat-api.md) · [All operations](https://skmtc.dev/superchat/apis/superchat-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/superchat/superchat-api/revisions/3bc557a0072f/schema)