> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# segmentTokenFieldOptions

> Look up this store's allowed values for a catalog field (tags, products, countries, custom fields, event names). The catalog is static; these values are not.

**Required scopes:** [`segments_read`](/docs/api-reference/v3/reference/scopes#scope-segments_read)

## Arguments

<ResponseField name="activity" type="String">
  Required when `kind` is CUSTOMER\_ACTIVITY: the activity's catalog `id` (the stored `event` value).
</ResponseField>

<ResponseField name="field" type="String!" required>
  Catalog field id: an attribute id, an activity field id, or `eventName` for custom events.
</ResponseField>

<ResponseField name="kind" type={<a href="/docs/api-reference/v3/reference/marketing/segment-condition-kind">SegmentConditionKind!</a>} required>
  Which condition kind the field belongs to.
</ResponseField>

<ResponseField name="prerequisiteValues" type="[String!]">
  Parent tokens for hierarchy and custom fields. Omit for custom-fields to list declarations, then pass `[declarationId]` to list values. Country before state; country+state before city.
</ResponseField>

<ResponseField name="search" type="String">
  Case-insensitive substring filter.
</ResponseField>

## Returns

<ResponseField name="segmentTokenFieldOptions" type={<a href="/docs/api-reference/v3/reference/marketing/segment-token-field-options">SegmentTokenFieldOptions!</a>} required>
  Store-specific values for a catalog field that needs token options.

  <Expandable title="fields" lazyRender>
    <ResponseField name="items" type={<a href="/docs/api-reference/v3/reference/marketing/segment-token-option">[SegmentTokenOption!]!</a>} required>
      Matching values, most relevant first.

      <Expandable title="fields" lazyRender>
        <ResponseField name="id" type="String!" required>
          Value to store on the condition.
        </ResponseField>

        <ResponseField name="name" type="String!" required>
          Merchant-facing label for this value.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```graphql theme={null}
query {
  segmentTokenFieldOptions(activity: "...", field: "...", kind: CUSTOMER_ACTIVITY, prerequisiteValues: "...", search: "...")
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.