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.
Authorizations
OAuth2 access token obtained via the authorization flow. Include in the Authorization header as: Bearer {access_token}
Query Parameters
Page number
x >= 1Results per page (1-100)
1 <= x <= 100Filter by survey status. Comma-separated values: completed, in-progress, unpublished, archived
Filter by question type. Comma-separated values: head_to_head, ranked, open_ended, click_test, etc.
Filter by option type (e.g. text, image). Comma-separated.
Filter by country codes. Comma-separated (e.g. US,GB,CA).
Filter by tag IDs — opaque identifiers (tag_<32-hex>) and/or legacy integers, mixed freely. Comma-separated.
Filter by audience IDs. Comma-separated.
Full-text search across survey names and questions
255Filter by team member ID(s) — opaque identifiers (usr_<32-hex>, as returned by GET /users) and/or legacy integers, mixed freely. Comma-separated.
Filter by project GUIDs or numeric IDs. Comma-separated.
Only include surveys published after this ISO 8601 datetime
Field to sort by
createdAt, name, creator, status Sort direction
asc, desc 