---
title: "List custom field values"
method: GET
path: "/workflows/custom_fields/values"
tags: ["Workflows"]
---

# List custom field values

`GET /workflows/custom_fields/values`

Returns the custom field values for a given entity.

🔒 Requires: `custom_fields:read` scope

## Query parameters

- `entity` 'sale' | 'line_item' | 'customer' | 'product', required
- `entity_id` string, required

## Response `200`

A list of all the custom field values associated with entity.

- CustomFieldValueCollection — The fields returned by the custom field value list API.
  - `data` CustomFieldValue[], required — An array of Custom Field Values.
    - `boolean_value` boolean
    - `definition_id` string — The ID of the custom field definition associated with this value.
    - `integer_value` integer
    - `name` string
    - `string_value` string
    - `title` string
    - `type` 'string' | 'integer' | 'boolean' | 'date' — The type of the value to be stored using this custom field.

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)