---
title: "List surveys"
method: GET
path: "/api/surveys"
tags: ["surveys"]
---

# List surveys

`GET /api/surveys`

Retrieve a list of surveys configured on the platform.

### Surveys Overview:
- Surveys are admin-defined questionnaires consisting of multiple choice or text polls.
- Requires Administrator authorization.
- Supports standard pagination controls and active status filtering.

## Query parameters

- `page` integer
- `per_page` integer
- `active` boolean

## Response `200`

A list of surveys

- Survey[]
  - `type_of` 'survey', required — Resource discriminator
  - `id` integer, required
  - `title` string, required
  - `slug` string, required
  - `survey_type_of` 'community_pulse' | 'industry' | 'fun', required — Survey category
  - `active` boolean, nullable — Whether the survey is currently active
  - `display_title` boolean, required — Whether to show the title to respondents
  - `allow_resubmission` boolean, required — Whether users can submit multiple times
  - `daily_email_distributions` integer — Daily email distributions count
  - `extra_email_context_paragraph` string, nullable — Optional context paragraph for emails
  - `target_response_count` integer — Target response count
  - `target_completion_date` string, date-time, nullable — Target completion date in the future
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `401` — Unauthorized

## Changes

> 59 revisions in range; 8 could not be searched.

- **2026-07-21** (v1) `ffddb865fa73` — 4 info
  - added the optional property `items/daily_email_distributions` to the response with the `200` status
  - added the optional property `items/extra_email_context_paragraph` to the response with the `200` status
  - added the optional property `items/target_completion_date` to the response with the `200` status
  - added the optional property `items/target_response_count` to the response with the `200` status
- **2026-07-13** (v1) `189b62b952ea` — 1 breaking
  - removed the media type `application/json` for the response with the status `401`
- **2026-07-13** (v1) `7db6ba099285` — 1 breaking
  - removed the media type `application/json` for the response with the status `401`
- **2026-05-28** (v1) `6550ad7be94f` — 1 info
  - added the media type `application/json` for the response with the status `401`
- **2026-03-19** (v1) `8dae809f0fde` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/forem/apis/forem-api-v1/changes/api/surveys/get.md)

---

[API](https://skmtc.dev/forem/apis/forem-api-v1.md) · [All operations](https://skmtc.dev/forem/apis/forem-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/forem/forem-api-v1/revisions/1f64f71fc2a7/schema)