---
title: "List Field Configuration Items"
method: GET
path: "/field-configurations/{id}/items"
tags: ["Field Configuration"]
---

# List Field Configuration Items

`GET /field-configurations/{id}/items`

Returns a paginated list of items belonging to a field configuration.

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `size` integer

## Response `200`

Items successfully retrieved.

- ListFieldConfigurationItemsResponse — Paginated envelope containing a list of items belonging to a single field configuration.
  - `data` FieldConfigurationItem[] — Field-configuration items for the current page.
    - `uuid` string, required — Unique identifier of the item.
    - `fieldConfigurationUUID` string, required — UUID of the parent field configuration.
    - `title` string, required — Short human-readable title of the item. Trimmed; 1-128 characters.
    - `category` 'CRM' | 'Indicators' | 'BuiltInInsight' | 'CustomInsight', required — Category of the item. One of the intelligence-category enum values.
    - `contents` string, required — Prompt text that Attention will evaluate against each conversation.
    - `description` string — Optional longer description shown to end users. 0-2000 characters.
    - `promptType` string, required — Prompt family used to analyze the conversation.
    - `contentType` string, required — Expected shape of the extracted content.
    - `responseType` string — Optional response data type hint.
    - `options` string[] — Optional allowed response values when the item is a multiple-choice field.
    - `dependsOn` string[] — UUIDs of other items this item depends on.
    - `maxValues` integer — Maximum number of values allowed for multi-select items.
    - `allowLongResponse` boolean, required — Whether the analyzer may produce a longer free-text response.
    - `extractQuotes` boolean, required — Whether the analyzer should attach supporting quotes to the response.
    - `availableToAllClients` boolean, required — Internal flag marking the item as globally available.
    - `analysisLevel` 'conversation' | 'deal' | 'lead' | 'contact' | 'account' — Level at which the item is evaluated.
    - `metadata` FieldConfigurationItemMetadata — Numeric scoring metadata for a field-configuration item. Required when the item represents a numeric score - `min_score` must be less than or equal to `max_score`.
      - `min_score` number, double — Minimum allowed score value.
      - `max_score` number, double — Maximum allowed score value.
      - `middle_score` number, double, nullable — Optional midpoint score value, used by scoring heuristics.
      - `min_criteria` string — Human-readable description of what the minimum score means.
      - `max_criteria` string — Human-readable description of what the maximum score means.
      - `middle_criteria` string, nullable — Human-readable description of what the middle score means.
    - `createdAt` string, date-time, required — Timestamp when the item was created.
    - `lastModifiedAt` string, date-time, required — Timestamp when the item was last updated.
  - `meta` Meta
    - `pageCount` integer
    - `totalRecords` integer
    - `pageNumber` integer
    - `pageSize` integer

## Other responses

- `400` — Invalid pagination parameters.
- `401` — Authentication failed. Please provide a valid API key.
- `404` — No field configuration with the provided UUID exists in the organization.
- `default` — Unexpected error.

---

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