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

# Get Scorecard

`GET /scorecards/{id}`

Retrieves a single scorecard by its UUID, scoped to the caller's organization. Cross-organization lookups return 404 to prevent existence leaks.

## Path parameters

- `id` string, required

## Response `200`

Scorecard successfully retrieved

- ScorecardResponse — Single-resource envelope wrapping a Scorecard.
  - `data` Scorecard, required — A scorecard template used to evaluate a conversation, chat, or email.
    - `uuid` string, required — Scorecard UUID.
    - `title` string, required — Human-readable title of the scorecard (1-128 characters).
    - `organizationUUID` string, required — UUID of the organization that owns the scorecard.
    - `teamUUID` string — UUID of the specific team assigned to this scorecard, if any. Mutually exclusive with allTeams=true.
    - `allTeams` boolean, required — Whether the scorecard is assigned to every team in the organization.
    - `enabled` boolean, required — Whether the scorecard is active and runs against new interactions.
    - `interactionType` 'conversation' | 'chat' | 'email', required — Type of interaction the scorecard evaluates.
    - `detailedInstructions` string — Optional free-form guidance appended to the evaluator prompt.
    - `scorecardPrompt` string — Optional prompt override used in expert mode.
    - `expertMode` boolean, required — Whether this scorecard uses custom prompts (expert mode) instead of the default template.
    - `isDefaultTemplate` boolean, required — Whether this scorecard was seeded as one of the default organization templates.
    - `criteria` ScorecardCriteria — Label-based criteria that gate when a scorecard is applied to an interaction.
      - `operator` 'AND' | 'OR' — Boolean operator joining criteria conditions.
      - `conditions` ScorecardCriteriaCondition[] — List of field/value conditions evaluated with the operator.
        - `field` string — Field path being matched (for example, a label UUID or label option UUID).
        - `value` string — Expected value for the field to satisfy the condition.
    - `createdAt` string, date-time, required — Timestamp when the scorecard was created.

## Other responses

- `401` — Authentication failed - valid API key required
- `404` — Scorecard not found in the caller's organization (returned for both missing and cross-org IDs)
- `default` — Unexpected error occurred while retrieving the scorecard

---

[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/versions/5de55d3804cf/schema)