---
title: "List a field's values"
method: GET
path: "/api/v3/charts/fields/{field}/values"
tags: ["V3 Charts"]
---

# List a field's values

`GET /api/v3/charts/fields/{field}/values`

## Request

- Base URL: `https://app.formbricks.com`
- URL: `https://app.formbricks.com/api/v3/charts/fields/{field}/values`
- Auth: one of:
  - API key in cookie `next-auth.session-token`
  - API key in header `x-api-key`
  - HTTP bearer

Returns up to 100 distinct stored values of a field, so a filter can use a value that really
occurs — an `equals` filter on a picked value cannot miss on casing or spacing. Only fields the
catalog marks `valueLookup: true` qualify; any other field, or one outside the catalog, answers
422. Narrow a field with more values using `search`. The list is not paged.

Needs read access to the workspace and the Feedback Dataset. Counts against the chart-query
budget (600 per minute, 20 at once, per user or API key), not the v3 default.

## Path parameters

- `field` string, required

## Query parameters

- `workspaceId` string, cuid2, required
- `datasetId` string, cuid2, required
- `search` string

## Response `200`

The field's values, in ascending order

- object
  - `data` object[], required
    - `value` string, required
    - `fieldType` string: The question type, present when the field is `FeedbackRecords.fieldLabel`.

## Other responses

- `400`: Bad Request — malformed JSON, invalid query/body/params, duplicate name, or unsupported field.
- `401`: Not authenticated (no valid session or API key).
- `403`: Forbidden. `code: forbidden` when the caller has no access to the workspace, the Feedback Dataset or the resource (which may also not exist; 404 is not used, to avoid leaking existence). `code: dashboards_plan_required` when the caller is authorized but the organization does not have the Dashboards add-on or a license that includes it — checked after authorization, so a caller without access never learns the organization's plan.
- `422`: Unprocessable Content — semantic validation failed or the requested lifecycle transition is invalid.
- `429`: Too Many Requests (`code: too_many_requests`). Chart data, preview and field-value lookups share one budget of 600 requests per minute per user or API key, separate from the 100 per minute of the rest of v3, so a dashboard can load every widget's data. At most 20 of them run at once per user or key; past that the answer is 429 with `Retry-After: 1`. `Retry-After` says when to retry.
- `500`: Internal Server Error.
- `502`: Bad Gateway (`code: bad_gateway`) — the chart query could not be run: the analytics engine was unreachable, refused it, or it ran longer than the one-minute limit and was stopped. The engine's own error is never returned. Retrying later is safe; a query that timed out needs a narrower date range or grouping.

## Changes

- **2026-10-28** `84820a01e550`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/formbricks/apis/formbricks-api-v3/changes/api/v3/charts/fields/:field/values/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.dev/formbricks/apis/formbricks-api-v3/revisions/25335c959a13?raw)