---
title: "Danh sách khảo sát (mọi trạng thái)"
method: GET
path: "/admin/surveys"
tags: ["SurveysAdmin"]
---

# Danh sách khảo sát (mọi trạng thái)

`GET /admin/surveys`

## Request

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

## Query parameters

- `status` 0 | 1 | 2 | 3
- `keyword` string
- `includeDeleted` boolean
- `offset` integer
- `limit` integer

## Response `200`

Thành công

- FireAntApiModelsSurveysSurveyPagedResultFireAntApiModelsSurveysSurveyItem: Kết quả phân trang
  - `items` FireAntApiModelsSurveysSurveyItem[]: Danh sách phần tử của trang hiện tại
    - `surveyId` integer: ID khảo sát
    - `code` string: Mã/slug khảo sát (tùy chọn)
    - `title` string: Tiêu đề
    - `description` string: Mô tả
    - `thankYouMessage` string: Lời cảm ơn hiển thị sau khi gửi
    - `imageUrl` string: Ảnh minh họa
    - `status` 0 | 1 | 2 | 3: Trạng thái (0 = Draft, 1 = Published, 2 = Closed, 3 = Archived)
    - `isAnonymous` boolean: Cho phép trả lời không cần đăng nhập
    - `allowMultipleResponses` boolean: Cho phép một người trả lời nhiều lần
    - `showResults` boolean: Cho phép người trả lời xem kết quả tổng hợp
    - `startDate` string, date-time: Thời điểm bắt đầu nhận phản hồi (null = ngay khi publish)
    - `endDate` string, date-time: Thời điểm kết thúc nhận phản hồi (null = không giới hạn)
    - `maxResponses` integer: Số phản hồi tối đa (null = không giới hạn)
    - `targetAudience` string: Nhóm đối tượng (all, premium, ios, android...)
    - `priority` integer: Ưu tiên hiển thị (cao hơn lên trước)
    - `displayMode` 0 | 1 | 2: Cách hiển thị trên App/Web: 0 ListOnly, 1 Banner, 2 Prompt (0 = ListOnly, 1 = Banner, 2 = Prompt)
    - `dismissible` boolean: Cho phép người dùng "Để sau" / "Không quan tâm"
    - `snoozeDays` integer: Số ngày ẩn khảo sát khi người dùng chọn "Để sau"
    - `showToGuests` boolean: Khảo sát yêu cầu đăng nhập vẫn hiện với khách chưa đăng nhập (client mời đăng nhập khi bấm vào)
    - `presentationMode` 0 | 1 | 2: Chế độ trình bày: 0 cuộn một trang, 1 mỗi Section một trang, 2 mỗi câu một màn hình (0 = Scroll, 1 = SectionPages, 2 = OneByOne)
    - `settings` FireAntApiModelsSurveysSurveySettings: Thiết lập trình bày của khảo sát (JSON trong Surveys.Settings). Client dùng; bỏ trống = mặc định.
      - `autoAdvance` boolean: Tự chuyển sang câu sau khi chọn xong câu chọn một / Có-Không / thang điểm (chế độ từng câu). Mặc định true
      - `showWelcome` boolean: Hiện màn hình mở đầu (ảnh bìa, thời gian ước tính, nút Bắt đầu) ở chế độ từng câu. Mặc định true
      - `showProgress` boolean: Hiện thanh tiến độ. Mặc định true
      - `allowBack` boolean: Cho quay lại câu trước. Mặc định true
      - `celebrate` boolean: Hiệu ứng chúc mừng khi hoàn thành. Mặc định true
      - `showQuestionNumbers` boolean: Hiện số thứ tự câu hỏi. Mặc định true
      - `accentColor` string: Màu nhấn của khảo sát (#RRGGBB). Bỏ trống = màu thương hiệu của ứng dụng
      - `welcomeTitle` string: Tiêu đề màn hình mở đầu (bỏ trống = tiêu đề khảo sát)
      - `welcomeButton` string: Nhãn nút bắt đầu (bỏ trống = "Bắt đầu")
      - `estimatedMinutes` integer: Thời gian ước tính (phút) ghi đè cách tính tự động
    - `isDismissed` boolean: Người dùng hiện tại đang bỏ qua khảo sát này (Để sau còn hạn hoặc Không quan tâm)
    - `dismissedUntil` string, date-time: Ẩn đến thời điểm này (null nếu không bỏ qua hoặc ẩn hẳn)
    - `dismissCount` integer: Số người đã bỏ qua khảo sát (admin)
    - `targetCount` integer: Số đối tượng khảo sát được gắn vào (0 = khảo sát chung)
    - `targetSummary` string: Tóm tắt đối tượng gắn kèm cho admin, ví dụ "symbol:FPT, post:40203799"
    - `targets` FireAntApiModelsSurveysSurveyTargetItem[]: Đối tượng gắn kèm (có trong chi tiết và danh sách người dùng cuối)
      - `targetId` integer: ID bản ghi
      - `surveyId` integer: ID khảo sát
      - `targetType` string: Loại đối tượng (chữ thường): post, symbol, room, user, event, article, url...
      - `targetKey` string: Khóa đối tượng: postId, mã CK (viết hoa), roomId, userId, URL...
      - `orderIndex` integer: Thứ tự hiển thị
    - `questionCount` integer: Số câu hỏi
    - `responseCount` integer: Số phản hồi đã nhận
    - `hasResponded` boolean: Người dùng hiện tại đã trả lời khảo sát này chưa
    - `hasDraft` boolean: Người dùng hiện tại đang có bản nháp chưa gửi
    - `draftCount` integer: Số bản nháp đang tồn tại (admin)
    - `isActive` boolean: Khảo sát đang trong thời gian nhận phản hồi
    - `createdBy` string: Người tạo
    - `createdDate` string, date-time: Ngày tạo
    - `updatedBy` string: Người cập nhật cuối
    - `updatedDate` string, date-time: Ngày cập nhật cuối
    - `publishedDate` string, date-time: Ngày publish
    - `closedDate` string, date-time: Ngày đóng
    - `isDeleted` boolean: Đã xóa mềm
  - `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

## Other responses

- `403`: Không có quyền

## Changes

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

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