---
title: "Get Scorecard Item"
method: GET
path: "/scorecards/{id}/items/{itemId}"
tags: ["Scorecard"]
---

# Get Scorecard Item

`GET /scorecards/{id}/items/{itemId}`

## Request

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

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

## Path parameters

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

## Response `200`

Scorecard item successfully retrieved

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

## Other responses

- `401`: Authentication failed - valid API key required
- `404`: Scorecard or item not found in the caller's organization
- `default`: Unexpected error occurred while retrieving the scorecard item

---

[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)