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

# Get Scorecard Item

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

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.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/revisions/5de55d3804cf/schema)