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

# Attention: Get Scorecard Item

> Get one scoring criterion from an Attention scorecard. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Get one scoring criterion from an Attention scorecard.

> [!NOTE]
>
> Tool ID: `attention_get_scorecard_item`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'attention_get_scorecard_item',
  {
    "id": "id_123",
    "itemId": "item_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute attention_get_scorecard_item --input '{
  "id": "id_123",
  "itemId": "item_123"
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "data": {
      "uuid": "uuid_123",
      "scorecardUUID": "scorecard_123",
      "title": "VP of Engineering",
      "type": "numeric",
      "position": 123,
      "weight": 123,
      "version": 123,
      "createdAt": "2026-01-15T12:00:00Z",
      "lastUpdatedAt": "2026-01-15T12:00:00Z"
    }
  }
}
```

Use `deepline describe attention_get_scorecard_item --json` for the latest machine-readable contract.

## Input reference

Retrieves a single scorecard item. Both the parent scorecard and the item must belong to the caller's organization.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.id` | `string` | Yes | — | Parent scorecard UUID |
| `payload.itemId` | `string` | Yes | — | Scorecard item UUID |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieves a single scorecard item. Both the parent scorecard and the item must belong to the caller's organization.",
    "properties": {
      "id": {
        "type": "string",
        "description": "Parent scorecard UUID"
      },
      "itemId": {
        "type": "string",
        "description": "Scorecard item UUID"
      }
    },
    "required": [
      "id",
      "itemId"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Single-resource envelope wrapping a ScorecardItem. |
| `result.data.data` | `object` | Yes | — | A single scoring criterion belonging to a scorecard template. |
| `result.data.data.uuid` | `string` | Yes | — | Scorecard item UUID. |
| `result.data.data.scorecardUUID` | `string` | Yes | — | UUID of the parent scorecard. |
| `result.data.data.title` | `string` | Yes | — | Human-readable title of the item (1-128 characters). |
| `result.data.data.type` | `"numeric"` | Yes | — | Scoring type for a scorecard item. Currently only numeric is supported. Allowed: `numeric`. |
| `result.data.data.position` | `integer` | Yes | — | Zero-indexed ordering position among siblings on the parent scorecard. |
| `result.data.data.weight` | `integer` | Yes | — | Relative weight of this item within the scorecard (0-100). |
| `result.data.data.version` | `integer` | Yes | — | Monotonic version counter incremented on each update. |
| `result.data.data.expertPrompt` | `string` | No | — | Optional expert-mode prompt override for this specific item. |
| `result.data.data.metadata` | `object` | No | — | Type-discriminated metadata for a scorecard item. Numeric items populate numericMetadata. |
| `result.data.data.metadata.numericMetadata` | `object` | No | — | Configuration for a numeric scorecard item including score range and per-bucket criteria. |
| `result.data.data.metadata.numericMetadata.min` | `integer \| null` | No | — | Minimum score value (inclusive). |
| `result.data.data.metadata.numericMetadata.middle` | `integer \| null` | No | — | Optional middle score anchor. When present, a middleCriteria is required. |
| `result.data.data.metadata.numericMetadata.max` | `integer \| null` | No | — | Maximum score value (inclusive). |
| `result.data.data.metadata.numericMetadata.minCriteria` | `string` | No | — | Guidance for the evaluator describing what a minimum score looks like. |
| `result.data.data.metadata.numericMetadata.middleCriteria` | `string` | No | — | Guidance for the evaluator describing what the middle score looks like. Required when middle is set. |
| `result.data.data.metadata.numericMetadata.maxCriteria` | `string` | No | — | Guidance for the evaluator describing what a maximum score looks like. |
| `result.data.data.createdAt` | `string` | Yes | — | Timestamp when the item was created. Format: `date-time`. |
| `result.data.data.lastUpdatedAt` | `string` | Yes | — | Timestamp of the most recent update. Format: `date-time`. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Single-resource envelope wrapping a ScorecardItem.",
        "properties": {
          "data": {
            "type": "object",
            "description": "A single scoring criterion belonging to a scorecard template.",
            "properties": {
              "uuid": {
                "type": "string",
                "description": "Scorecard item UUID."
              },
              "scorecardUUID": {
                "type": "string",
                "description": "UUID of the parent scorecard."
              },
              "title": {
                "type": "string",
                "description": "Human-readable title of the item (1-128 characters)."
              },
              "type": {
                "type": "string",
                "description": "Scoring type for a scorecard item. Currently only numeric is supported.",
                "enum": [
                  "numeric"
                ]
              },
              "position": {
                "type": "integer",
                "description": "Zero-indexed ordering position among siblings on the parent scorecard."
              },
              "weight": {
                "type": "integer",
                "description": "Relative weight of this item within the scorecard (0-100)."
              },
              "version": {
                "type": "integer",
                "description": "Monotonic version counter incremented on each update."
              },
              "expertPrompt": {
                "type": "string",
                "description": "Optional expert-mode prompt override for this specific item."
              },
              "metadata": {
                "type": "object",
                "description": "Type-discriminated metadata for a scorecard item. Numeric items populate numericMetadata.",
                "properties": {
                  "numericMetadata": {
                    "type": "object",
                    "description": "Configuration for a numeric scorecard item including score range and per-bucket criteria.",
                    "properties": {
                      "min": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "Minimum score value (inclusive)."
                      },
                      "middle": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "Optional middle score anchor. When present, a middleCriteria is required."
                      },
                      "max": {
                        "type": [
                          "integer",
                          "null"
                        ],
                        "description": "Maximum score value (inclusive)."
                      },
                      "minCriteria": {
                        "type": "string",
                        "description": "Guidance for the evaluator describing what a minimum score looks like."
                      },
                      "middleCriteria": {
                        "type": "string",
                        "description": "Guidance for the evaluator describing what the middle score looks like. Required when middle is set."
                      },
                      "maxCriteria": {
                        "type": "string",
                        "description": "Guidance for the evaluator describing what a maximum score looks like."
                      }
                    },
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              },
              "createdAt": {
                "type": "string",
                "description": "Timestamp when the item was created.",
                "format": "date-time"
              },
              "lastUpdatedAt": {
                "type": "string",
                "description": "Timestamp of the most recent update.",
                "format": "date-time"
              }
            },
            "required": [
              "createdAt",
              "lastUpdatedAt",
              "position",
              "scorecardUUID",
              "title",
              "type",
              "uuid",
              "version",
              "weight"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Attention provider guide](https://deepline.com/docs/providers/attention/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


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