---
title: "Get Heads Up completion counts"
method: POST
path: "/announcements/v1/announcement:GetHeadsUpCompletionCounts"
tags: ["Heads Up"]
---

# Get Heads Up completion counts

`POST /announcements/v1/announcement:GetHeadsUpCompletionCounts`

## Request body

- S12CommonRequestByID
  - `id` string, required — ID to query data for

## Response `200`

A successful response.

- S12AnnouncementsV1GetHeadsUpCompletionCountsResponse — Result returned from `GetHeadsUpCompletionCounts`
  - `viewed_count` integer — ViewedCount represents the total number of assigned users who have viewed a HeadsUp
  - `acknowledged_count` integer — AcknowledgedCount represents the total number of users who have acknowledged a HeadsUp.
  - `message_count` integer — MessageCount represents the total number of comments on this HeadsUp.
  - `reaction_summary` S12AnnouncementsV1HeadsUpReactionSummary[] — Reactions associated for the assigned heads up
    - `emoji_short_code` string — A string which represents the short code of the emoji
    - `total_reaction_count` integer — the number of reactions for the given emoji_short_code
    - `did_user_react` boolean — returns true if the requesting user reacted with the given emoji_short_code, otherwise false
    - `users` S12AnnouncementsV1HeadsUpReactionUser[] — The list of users who reacted with the given emoji_short_code
      - `user_id` string — ID of the user who reacted
      - `user_full_name` string — Name of the user who reacted
      - `user_profile_picture` S12CommonMedia
        - `id` string
        - `token` string
        - `filename` string — full file name, including file extension
        - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV' — - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
      - `created_at` string, date-time — The time the user reacted
    - `reaction_user_limit` integer — The maximum number of HeadsUpReactionUsers that will be returned. Should be use with total count to calculate "and X others."

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/safetyculture/apis/safetyculture-api.md) · [All operations](https://skmtc.net/safetyculture/apis/safetyculture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safetyculture/safetyculture-api/revisions/5be91df61ded/schema)