---
title: "Thống kê tổng hợp (chỉ phản hồi hoàn thành): theo câu hỏi, lựa chọn, phân phối điểm, ô ma trận, mã CK"
method: GET
path: "/admin/surveys/{surveyId}/statistics"
tags: ["SurveysAdmin"]
---

# Thống kê tổng hợp (chỉ phản hồi hoàn thành): theo câu hỏi, lựa chọn, phân phối điểm, ô ma trận, mã CK

`GET /admin/surveys/{surveyId}/statistics`

## Request

- Base URL: `https://api.fireant.vn`
- URL: `https://api.fireant.vn/admin/surveys/{surveyId}/statistics`
- Auth: OAuth 2
  - Implicit: `https://accounts.fireant.vn/connect/authorize`
  - Scopes: `user-data-read`
- TypeScript: <https://skmtc.dev/fireant/apis/fireant-restful-api/docs/admin/surveys/:surveyId/statistics/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `surveyId` integer, required

## Response `200`

Thành công

- FireAntApiModelsSurveysSurveyStatistics: Thống kê tổng hợp của một khảo sát
  - `surveyId` integer: ID khảo sát
  - `title` string: Tiêu đề khảo sát
  - `status` 0 | 1 | 2 | 3: Trạng thái (0 = Draft, 1 = Published, 2 = Closed, 3 = Archived)
  - `totalResponses` integer: Tổng số phản hồi đã hoàn thành
  - `draftCount` integer: Số bản nháp chưa gửi
  - `dismissCount` integer: Số người đã bỏ qua ("Để sau" hoặc "Không quan tâm")
  - `permanentDismissCount` integer: Số người chọn "Không quan tâm"
  - `uniqueUsers` integer: Số người dùng (đăng nhập) duy nhất
  - `anonymousResponses` integer: Số phản hồi ẩn danh
  - `firstResponseDate` string, date-time: Phản hồi đầu tiên
  - `lastResponseDate` string, date-time: Phản hồi gần nhất
  - `avgDurationSeconds` number, double: Thời gian hoàn thành trung bình (giây)
  - `responsesToday` integer: Số phản hồi hôm nay
  - `responsesLast7Days` integer: Số phản hồi 7 ngày gần nhất
  - `outcomeCount` integer: Số phản hồi có hành động sau khảo sát
  - `viewCount` integer: Tổng lượt xem khảo sát (admin)
  - `startedCount` integer: Số người bắt đầu (bản nháp + hoàn thành) (admin)
  - `funnel` FireAntApiModelsSurveysSurveyFunnelStep[]: Phễu: số người đi tới từng câu và dừng ở câu đó (admin)
    - `questionId` integer: ID câu hỏi
    - `reached` integer: Số người đi tới câu này (gồm mọi phản hồi hoàn thành)
    - `droppedHere` integer: Số bản nháp đang dừng ở câu này
  - `questions` FireAntApiModelsSurveysSurveyQuestionStatistics[]: Thống kê theo từng câu hỏi (không gồm Section)
    - `questionId` integer: ID câu hỏi
    - `questionText` string: Nội dung câu hỏi
    - `questionType` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17: Loại câu hỏi (1 = SingleChoice, 2 = MultipleChoice, 3 = Text, 4 = Rating, 5 = YesNo, 6 = Number, 7 = Date, 8 = Dropdown, 9 = Matrix, 10 = Ranking, 11 = FileUpload, 12 = Symbol, 13 = DateRange, 14 = Slider, 15 = Section, 16 = Hotspot, 17 = FillInBlank)
    - `orderIndex` integer: Thứ tự
    - `isRequired` boolean: Bắt buộc
    - `answerCount` integer: Số phản hồi có trả lời câu này
    - `skippedCount` integer: Số phản hồi bỏ qua câu này
    - `avgNumber` number, double: Trung bình (Rating/Number/Slider)
    - `minNumber` number, double: Nhỏ nhất
    - `maxNumber` number, double: Lớn nhất
    - `textAnswerCount` integer: Số câu trả lời dạng text (tự luận, "Khác", URL tệp, mã CK)
    - `options` FireAntApiModelsSurveysSurveyOptionStatistics[]: Thống kê theo lựa chọn (Matrix: cả dòng và cột; Ranking: avgNumber = thứ hạng trung bình)
      - `questionId` integer: ID câu hỏi
      - `optionId` integer: ID lựa chọn
      - `optionText` string: Nội dung lựa chọn
      - `optionValue` string: Giá trị nội bộ
      - `orderIndex` integer: Thứ tự
      - `isOther` boolean: Là lựa chọn "Khác"
      - `optionGroup` 0 | 1 | 2 | 3: Nhóm (Choice / MatrixColumn) (0 = Choice, 1 = MatrixColumn, 2 = Blank, 3 = BlankChoice)
      - `imageUrl` string: Ảnh minh họa
      - `selectionCount` integer: Số lần được chọn (Matrix cột: số lần cột được chọn)
      - `avgNumber` number, double: Ranking: thứ hạng trung bình (thấp hơn = được ưu tiên hơn); Matrix thang điểm: điểm trung bình của dòng
      - `percentage` number, double: Tỷ lệ % trên số phản hồi trả lời câu hỏi này
    - `valueDistribution` FireAntApiModelsSurveysSurveyValueDistribution[]: Phân phối giá trị (Rating/Number/Slider)
      - `questionId` integer: ID câu hỏi
      - `value` number, double: Giá trị
      - `count` integer: Số lần
    - `matrixCells` FireAntApiModelsSurveysSurveyMatrixCellStatistics[]: Matrix: số lần chọn theo từng ô (dòng, cột)
      - `questionId` integer: ID câu hỏi
      - `rowOptionId` integer: ID dòng
      - `columnOptionId` integer: ID cột
      - `count` integer: Số lần
    - `textValues` FireAntApiModelsSurveysSurveyTextValueStatistics[]: Symbol: các mã được chọn nhiều nhất
      - `questionId` integer: ID câu hỏi
      - `value` string: Giá trị
      - `count` integer: Số lần
    - `hotspotBins` FireAntApiModelsSurveysSurveyHotspotBin[]: Hotspot: điểm chạm gộp theo lưới 40 x 40 (bản đồ nhiệt)
      - `questionId` integer: ID câu hỏi
      - `binX` integer: Cột 0..39 (trái sang phải)
      - `binY` integer: Dòng 0..39 (trên xuống dưới)
      - `count` integer: Số điểm chạm
    - `rangeEndDistribution` FireAntApiModelsSurveysSurveyValueDistribution[]: Slider chọn khoảng: phân bố đầu cuối (valueDistribution là đầu đầu)
      - `questionId` integer: ID câu hỏi
      - `value` number, double: Giá trị
      - `count` integer: Số lần
    - `blankValues` FireAntApiModelsSurveysSurveyBlankValueStatistics[]: FillInBlank: giá trị hay gặp của từng ô trống dạng chữ / số / mã CK (ô dạng chọn nằm ở matrixCells)
      - `questionId` integer: ID câu hỏi
      - `optionId` integer: optionId của ô trống
      - `value` string: Giá trị (chữ thường)
      - `count` integer: Số lần
  - `outcomes` FireAntApiModelsSurveysSurveyOutcomeStatistics[]: Số phản hồi khớp từng hành động sau khảo sát
    - `ruleId` integer: ID quy tắc
    - `orderIndex` integer: Thứ tự
    - `title` string: Tiêu đề
    - `buttonLabel` string: Nhãn nút
    - `actionType` 1 | 2 | 3 | 4: Loại hành động (1 = Url, 2 = AppRoute, 3 = Survey, 4 = Symbol)
    - `actionValue` string: Giá trị hành động (chưa thay placeholder)
    - `isDefault` boolean: Quy tắc mặc định
    - `count` integer: Số phản hồi đã khớp quy tắc này

## Changes

- **2026-09-25** `a481789cd81c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fireant/apis/fireant-restful-api/changes/admin/surveys/:surveyId/statistics/get.md)

---

[API](https://skmtc.dev/fireant/apis/fireant-restful-api.md) - [All operations](https://skmtc.dev/fireant/apis/fireant-restful-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireant/apis/fireant-restful-api/revisions/c9b3aa855f95?raw)