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

# List surveys

`GET /api/v3/surveys`

Returns surveys for the workspace. Session cookie or x-api-key.

## Query parameters

- `workspaceId` string, cuid2, required
- `limit` integer
- `cursor` string
- `includeTotalCount` boolean
- `filter[name][contains]` string
- `filter[status][in]` string[]
- `filter[type][in]` string[]
- `sortBy` 'createdAt' | 'updatedAt' | 'name' | 'relevance'

## Response `200`

Surveys retrieved successfully

- object
  - `data` SurveyListItem[], required
    - `id` string
    - `name` string
    - `workspaceId` string
    - `type` 'link' | 'app' | 'website' | 'web'
    - `status` 'draft' | 'inProgress' | 'paused' | 'completed'
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `responseCount` integer
    - `creator` object, nullable
      - `name` string
    - `singleUse` object, nullable
      - `enabled` boolean
      - `isEncrypted` boolean
  - `meta` object, required
    - `limit` integer, required
    - `nextCursor` string, nullable, required — Opaque cursor for the next page. `null` when there are no more results.
    - `totalCount` integer, nullable, required — Total number of surveys matching the current filters across all pages. `null` when `includeTotalCount=false`.

## Other responses

- `400` — Bad Request
- `401` — Not authenticated (no valid session or API key)
- `403` — Forbidden — no access, or workspace does not exist (404 not used; avoids existence leak)
- `429` — Rate limit exceeded
- `500` — Internal Server Error

## Changes

- **2026-06-05** `90798c12f7ae` — 30 warning
  - added the new `ai_features_not_enabled` enum value to the `code` response property for the response status `400`
  - added the new `ai_features_not_enabled` enum value to the `code` response property for the response status `401`
  - added the new `ai_features_not_enabled` enum value to the `code` response property for the response status `403`
  - added the new `ai_features_not_enabled` enum value to the `code` response property for the response status `429`
  - …26 more
- **2026-05-28** `b514d6392200` — 35 info
  - added the optional property `invalid_params/items/code` to the response with the `400` status
  - added the optional property `invalid_params/items/code` to the response with the `401` status
  - added the optional property `invalid_params/items/code` to the response with the `403` status
  - added the optional property `invalid_params/items/code` to the response with the `429` status
  - …31 more
- **2026-05-28** `23ec9fd15a38` — 6 info
  - deleted the `query` request parameter `environmentId` with deprecation
  - added the optional property `invalid_params/items/identifier` to the response with the `400` status
  - added the optional property `invalid_params/items/identifier` to the response with the `401` status
  - added the optional property `invalid_params/items/identifier` to the response with the `403` status
  - …2 more
- …earlier changes not shown

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

---

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