> For the complete documentation index, see [llms.txt](https://docs.ebbot.ai/ebbot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/list-field-values.md).

# List Easit Field Values

Check one Easit field's valid values by its systemName. Returns the field checked and, if it only accepts one of a fixed set (like status or category), every valid value as 'label (id)' text — use the id in Set Easit Item Field's value. A field with no fixed values accepts typed text or a number directly.

**Action identifier:** `list_field_values`.

### Inputs

| Field   | Type   | Required/default | Meaning                                                                       |
| ------- | ------ | ---------------- | ----------------------------------------------------------------------------- |
| `field` | string | Required         | Easit field systemName to check (populated as a dropdown from the connection) |

Example input:

```json
{
  "field": "sys_status"
}
```

### Output

Paths are relative to this action's output. Select them from the builder's variable picker rather than typing them. A field that is null or empty was not returned by Easit; it is not proof that the value is empty in Easit.

| Path     | Type   | Meaning                                                                                     |
| -------- | ------ | ------------------------------------------------------------------------------------------- |
| `field`  | string | Exact Easit field system name.                                                              |
| `values` | string | Valid choices as label (id) text, or an explanation for typed fields or empty data sources. |

### Declared errors

Instead of the output above, the action can return one of these objects. Check for them before using the output in a later step.

#### `FieldNotFound`

| Path     | Type    | Meaning                                         |
| -------- | ------- | ----------------------------------------------- |
| `exists` | boolean | False when no matching item or field was found. |
| `field`  | string  | Exact Easit field system name.                  |

#### `EasitUnavailable`

Easit could not be reached, or refused the request.

| Path        | Type           | Meaning                                                        |
| ----------- | -------------- | -------------------------------------------------------------- |
| `reachable` | boolean        | False when Easit could not be reached or rejected the request. |
| `endpoint`  | string \| null | Easit API endpoint involved in the failed request, when known. |
| `error`     | string         | Safe error code or diagnostic without credentials.             |
| `hint`      | string \| null | Suggested connection or permission check, when available.      |

### Behavior and limits

Checks the valid values for one known field in the configured module. Pass its exact system name, for example `{"field": "sys_status"}`; the form also offers a live field selector.

Returns `field` and `values` as readable `label (id)` text. Use the id in write actions. Text/number fields return a "no fixed values" message; an empty fixed-choice data source returns a distinct "no values configured" message.

Only the selected field's data source is walked. Unknown fields return declared `FieldNotFound`; unavailable Easit returns `EasitUnavailable`.

See [Troubleshooting](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/troubleshooting.md), or return to the [action catalog](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions.md).
