---
title: "List Scorecard Items"
method: GET
path: "/scorecards/{id}/items"
tags: ["Scorecard"]
---

# List Scorecard Items

`GET /scorecards/{id}/items`

Retrieves all items (scoring criteria) for a given scorecard, ordered by position ascending.

## Path parameters

- `id` string, required

## Query parameters

- `page` integer
- `size` integer

## Response `200`

Scorecard items successfully retrieved

- ListScorecardItemsResponse — Paginated collection envelope of scorecard items.
  - `data` ScorecardItem[], required — Page of scorecard items ordered by position ascending.
    - `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.
  - `meta` Meta, required
    - `pageCount` integer
    - `totalRecords` integer
    - `pageNumber` integer
    - `pageSize` integer

## Other responses

- `401` — Authentication failed - valid API key required
- `404` — Parent scorecard not found in the caller's organization
- `default` — Unexpected error occurred while listing scorecard items

---

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