---
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

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/announcements/v1/announcement:GetHeadsUpCompletionCounts`
- Auth: HTTP bearer

## 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.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
