---
title: "Get Field Configuration Item"
method: GET
path: "/field-configurations/{id}/items/{itemId}"
tags: ["Field Configuration"]
---

# Get Field Configuration Item

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

## Request

- Base URL: `https://api.attention.tech/v2`
- URL: `https://api.attention.tech/v2/field-configurations/{id}/items/{itemId}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/attention/apis/attention-service-v2/docs/field-configurations/:id/items/:itemId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a single field-configuration item by UUID. Items belonging to a field configuration in another organization return 404.

## Path parameters

- `id` string, required
- `itemId` string, required

## Response `200`

Item successfully retrieved.

- FieldConfigurationItemResponse: Envelope containing a single field-configuration item.
  - `data` FieldConfigurationItem: A single field within a Field Configuration (internally `IntelligenceItem`). Items describe a prompt that Attention evaluates against a conversation and produces a value for. A field-configuration item is cloned as one `IntelligenceItemAssignment` per team the parent configuration is assigned to - see `IntelligenceItemAssignment`.
    - `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.

## Other responses

- `401`: Authentication failed. Please provide a valid API key.
- `404`: No item with the provided UUID exists in the specified field configuration.
- `default`: Unexpected error.

---

[API](https://skmtc.dev/attention/apis/attention-service-v2.md) - [All operations](https://skmtc.dev/attention/apis/attention-service-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/attention/apis/attention-service-v2/revisions/cd99c71f42bb?raw)