---
title: "Get Scorecards Summary"
method: POST
path: "/scorecards/summary"
tags: ["Scorecard"]
---

# Get Scorecards Summary

`POST /scorecards/summary`

Retrieves detailed usage statistics for specified users or teams within a given time period.

## Request body

- ScorecardsSummaryRequest
  - `fromDateTime` string, date-time, required — Start date and time for filtering scorecards (ISO 8601 format)
  - `toDateTime` string, date-time, required — End date and time for filtering scorecards (ISO 8601 format)
  - `scorecardsItemsUUIDs` string[], required
  - `scorecardUUID` string, required
  - `teamUUIDs` string[], required
  - `userUUIDs` string[], required

## Response `200`

Scorecards summary successfully generated with detailed statistics

- ScorecardsSummaryResponse
  - `data` ScorecardsSummaryItem[], required — Array of resources matching the query
    - `overallScoreTotals` number, required
    - `min` number, required
    - `userName` string, required
    - `teamName` string, required
    - `metrics` ScorecardsSummaryMetricItem[], required
      - `overallScore` number, required
      - `itemAverages` ScorecardsSummaryItemAverage[], required
        - `title` string, required
        - `scorecardItemUUID` string, required
        - `average` number, required
        - `description` string
        - `evidence` object[]
          - `quote` string
          - `start_sec` number
          - `end_sec` number
          - `link` string — Deep link to the conversation at the evidence timestamp
      - `date` string, date-time, required
      - `entityInfo` object, required
        - `uuid` string, required
        - `title` string, required
      - `conversationInfo` object
        - `teamUUID` string, required
        - `userUUID` string, required
        - `startedAt` string, date-time, required
        - `uuid` string, required
        - `title` string, required
    - `max` number, required
    - `itemAverageTotals` ScorecardsSummaryItemAverage[], required
      - `title` string, required
      - `scorecardItemUUID` string, required
      - `average` number, required
      - `description` string
      - `evidence` object[]
        - `quote` string
        - `start_sec` number
        - `end_sec` number
        - `link` string — Deep link to the conversation at the evidence timestamp
    - `metricsCount` number, required

## Other responses

- `400` — Bad request - invalid request parameters
- `401` — Authentication failed - valid API key required
- `default` — Unexpected error occurred while generating the usage report

---

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