Surveys

List surveys

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

get/surveys

Request

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

Query parameters

pageinteger

Page number

limitinteger

Results per page (1-100)

statusstring

Filter by survey status. Comma-separated values: completed, in-progress, unpublished, archived

typestring

Filter by question type. Comma-separated values: head_to_head, ranked, open_ended, click_test, etc.

option_typestring

Filter by option type (e.g. text, image). Comma-separated.

countriesstring

Filter by country codes. Comma-separated (e.g. US,GB,CA).

tagsstring

Filter by tag IDs — opaque identifiers (tag_<32-hex>) and/or legacy integers, mixed freely. Comma-separated.

audiencesstring

Filter by audience IDs. Comma-separated.

textstring

Full-text search across survey names and questions

externalIdstring

Exact match on the optional opaque correlation key. Account-scoped. Not a text search.

member_idstring

Filter by team member ID(s) — opaque identifiers (usr_<32-hex>, as returned by GET /users) and/or legacy integers, mixed freely. Comma-separated.

project_idsstring

Filter by project GUIDs or numeric IDs. Comma-separated.

published_afterstring date-time

Only include surveys published after this ISO 8601 datetime

sort_by'createdAt' | 'name' | 'creator' | 'status'

Field to sort by

dir'asc' | 'desc'

Sort direction

Response

Default Response

Changes

No recorded changes to this operation across all 1 revision of this API.