---
title: "Danh sách phản hồi của khảo sát"
method: GET
path: "/admin/surveys/{surveyId}/responses"
tags: ["SurveysAdmin"]
---

# Danh sách phản hồi của khảo sát

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

## Request

- Base URL: `https://api.fireant.vn`
- URL: `https://api.fireant.vn/admin/surveys/{surveyId}/responses`
- 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/responses/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `surveyId` integer, required

## Query parameters

- `userName` string
- `fromDate` string, date-time
- `toDate` string, date-time
- `platform` string
- `responseStatus` 0 | 1
- `all` boolean
- `includeAnswers` boolean
- `offset` integer
- `limit` integer

## Response `200`

Thành công

- FireAntApiModelsSurveysSurveyPagedResultFireAntApiModelsSurveysSurveyResponseItem: Kết quả phân trang
  - `items` FireAntApiModelsSurveysSurveyResponseItem[]: Danh sách phần tử của trang hiện tại
    - `responseId` integer: ID phản hồi
    - `surveyId` integer: ID khảo sát
    - `userName` string: Tên đăng nhập người trả lời (null nếu ẩn danh)
    - `anonymousId` string: Định danh khách ẩn danh
    - `submittedDate` string, date-time: Thời điểm gửi (với bản nháp: lần lưu gần nhất)
    - `startedDate` string, date-time: Thời điểm bắt đầu (lần lưu nháp đầu tiên)
    - `status` 0 | 1: Trạng thái: Draft / Completed (0 = Draft, 1 = Completed)
    - `ipAddress` string: Địa chỉ IP
    - `userAgent` string: User agent
    - `platform` string: Nền tảng
    - `appVersion` string: Phiên bản ứng dụng
    - `durationSeconds` integer: Thời gian hoàn thành (giây)
    - `metadata` string: Dữ liệu bổ sung (JSON)
    - `answerCount` integer: Số câu hỏi đã trả lời
    - `outcomeRuleId` integer: ID hành động sau khảo sát đã khớp lúc gửi (null nếu không có)
    - `lastQuestionId` integer: Bản nháp: câu người dùng đang làm lần lưu gần nhất
    - `outcome` FireAntApiModelsSurveysSurveyOutcome: Hành động được chọn cho một phản hồi cụ thể (đã thay placeholder). Client hiển thị nút; người dùng bấm mới chuyển.
      - `ruleId` integer: ID quy tắc đã khớp
      - `title` string: Tiêu đề (tùy chọn)
      - `description` string: Mô tả (tùy chọn)
      - `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ị đã thay placeholder: URL / JSON route / SurveyId / mã CK
      - `openInNewTab` boolean: Mở tab mới (Url trên web)
    - `answers` FireAntApiModelsSurveysSurveyAnswerItem[]: Danh sách câu trả lời
      - `answerId` integer: ID câu trả lời
      - `responseId` integer: ID phản hồi
      - `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ự câu hỏi
      - `optionId` integer: ID lựa chọn (các loại chọn; Matrix: dòng; Ranking: lựa chọn được xếp hạng)
      - `optionText` string: Nội dung lựa chọn
      - `optionValue` string: Giá trị nội bộ của lựa chọn
      - `isOther` boolean: Lựa chọn là "Khác"
      - `subOptionId` integer: Matrix: ID cột được chọn
      - `subOptionText` string: Matrix: nội dung cột được chọn
      - `answerText` string: Text trả lời (Text, "Khác", URL tệp, mã cổ phiếu)
      - `answerNumber` number, double: Giá trị số (Rating/Number/Slider/YesNo; Ranking: thứ hạng; Matrix thang điểm: điểm)
      - `answerDate` string, date-time: Giá trị ngày (Date; DateRange: ngày bắt đầu)
      - `answerDateEnd` string, date-time: DateRange: ngày kết thúc
      - `answerNumberEnd` number, double: Hotspot: tọa độ Y (answerNumber là X); Slider chọn khoảng: đầu cuối
  - `totalCount` integer: Tổng số bản ghi thỏa điều kiện
  - `offset` integer: Vị trí bản ghi đầu tiên
  - `limit` integer: Số bản ghi tối đa của trang

## Changes

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

[Operation history](https://skmtc.dev/fireant/apis/fireant-restful-api/changes/admin/surveys/:surveyId/responses/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)