---
title: "List field values"
method: GET
path: "/entities/fields/{id}/values"
tags: ["fields"]
---

# List field values

`GET /entities/fields/{id}/values`

Returns a paginated list of allowed values for select-type and status fields (SINGLE_SELECT, MULTI_SELECT, TAG, STATUS).
Use this endpoint to retrieve all available options for fields with many values, or when you need
to paginate through all values.

For fields with fewer values (≤1000), the values are returned inline in the field response.
For fields with more values, the field response contains a reference to this endpoint.

Tag fields are returned using the same `SelectOptionValue` shape as MULTI_SELECT, since tags are multi-select internally.

## Path parameters

- `id` string, required

## Query parameters

- `assignedEntityType[]` EntityType[]
- `pageCursor` string

## Response `200`

A paginated list of field values

- object
  - `data` FieldValue[], required
    - union — A field value resource. The shape depends on the field type: - Select-type fields (SINGLE_SELECT, MULTI_SELECT, TAG): `SelectOptionValue` - Status fields: `StatusValue`
      - SelectOptionValue — A select option value resource (for SINGLE_SELECT, MULTI_SELECT, TAG fields).
        - `id` string, uuid, required — Unique identifier of the select option.
        - `fields` object, required
          - `name` string, required — Display name of the select option.
          - `color` 'red' | 'blue' | 'green' | 'yellow' | 'purple' | 'gray' | 'lime' | 'pink', required — Named color for a select option.
      - StatusValue — A status value resource. Only present for status fields where values can be scoped to entity types.
        - `id` string, uuid, required — Unique identifier of the status value.
        - `fields` object, required
          - `name` string, required — Display name of the status value.
          - `assignedEntityTypes` EntityType[] — Entity types this status value is assigned to.
  - `links` ListLinks
    - `next` string, nullable, required

## Other responses

- `400` — Bad Request - Invalid input format or malformed request
- `401` — Unauthorized - Missing or invalid authentication credentials
- `403` — Forbidden - Insufficient permissions
- `404` — Not Found - The requested resource does not exist or is not accessible
- `408` — Request Timeout - The server did not receive a complete request within the allowed time
- `429` — Too Many Requests - API rate limit exceeded, reduce request frequency and retry after the indicated time
- `500` — Internal Server Error - An unexpected error occurred on the server, please retry or contact support

---

[API](https://skmtc.net/productboard/apis/notes.md) · [All operations](https://skmtc.net/productboard/apis/notes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productboard/notes/versions/b4004749b60f/schema)