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

# List surveys

`GET /surveys`

## Request

- Base URL: `https://api.pickfu.com/v1`
- URL: `https://api.pickfu.com/v1/surveys`
- Auth: HTTP bearer

Returns a paginated list of surveys with filtering and sorting options. Use query parameters to filter by status, type, country, tags, projects, and more.

## Query parameters

- `page` integer
- `limit` integer
- `status` string
- `type` string
- `option_type` string
- `countries` string
- `tags` string
- `audiences` string
- `text` string
- `externalId` string
- `member_id` string
- `project_ids` string
- `published_after` string, date-time
- `sort_by` 'createdAt' | 'name' | 'creator' | 'status'
- `dir` 'asc' | 'desc'

## Response `200`

Default Response

- object
  - `data` object[]: List of surveys
    - `id` string: Survey GUID
    - `name` string: Survey name
    - `url` string: URL to view survey results
    - `status` string: Survey status: completed, in-progress, unpublished, or archived
    - `type` string: Primary question type
    - `countryCode` string, nullable: Two-letter country code
    - `sampleSize` number, nullable: Number of respondents requested
    - `numResponses` number: Number of responses collected
    - `createdAt` string, nullable: Creation timestamp (ISO 8601)
    - `publishedAt` string, nullable: Publication timestamp (ISO 8601)
    - `completedAt` string, nullable: Completion timestamp (ISO 8601)
    - `creatorName` string, nullable: Name of the team member who created the survey
    - `targeting` string[]: Targeting trait permalinks
    - `tags` object[]: Tags associated with the survey
      - `id` string, required: Opaque tag identifier (tag_<32-hex>)
      - `name` string, required: Tag name
    - `projects` object[]: Projects the survey belongs to
      - `id` string, required: Project GUID
      - `name` string, required: Project name
    - `externalId` string: Optional opaque correlation key. Omitted when unset. Case-sensitive and byte-exact.
    - `template` object, nullable: The template the survey was made from, or null. GET the survey for its constraints.
      - `id` string, nullable: Template id (cmb_...), or null when the template can no longer be addressed
      - `name` string
    - `elements` object[]: Questions in this survey (summary view)
      - `id` string: Question GUID
      - `question` string, nullable: Question text
      - `subtype` string: Question subtype
      - `variant` string, nullable: Question variant
      - `position` number: Display position
  - `pagination` object: Pagination metadata
    - `page` number: Current page number
    - `limit` number: Results per page
    - `total` number: Total number of results
    - `totalPages` number: Total number of pages

---

[API](https://skmtc.dev/pickfu/apis/pickfu-api.md) · [All operations](https://skmtc.dev/pickfu/apis/pickfu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pickfu/apis/pickfu-api/revisions/919fc58413ea?raw)