> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Attention: Get Scorecards Summary

> Get Scorecards Summary. Attention Get Scorecards Summary reference includes SDK V2 and CLI requests, input constraints, response fields, and Deepline cost.

Get Scorecards Summary.

<Info>
  Tool ID: `attention_get_scorecards_summary`
</Info>

## Run this action

Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV.

```ts theme={null}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'attention_get_scorecards_summary',
  {
    "fromDateTime": "2026-01-15T12:00:00Z",
    "toDateTime": "2026-01-15T12:00:00Z",
    "scorecardsItemsUUIDs": [
      "scorecards_items_123"
    ],
    "scorecardUUID": "scorecard_123",
    "teamUUIDs": [
      "team_123"
    ],
    "userUUIDs": [
      "user_123"
    ]
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={null}
deepline tools execute attention_get_scorecards_summary --input '{
  "fromDateTime": "2026-01-15T12:00:00Z",
  "toDateTime": "2026-01-15T12:00:00Z",
  "scorecardsItemsUUIDs": [
    "scorecards_items_123"
  ],
  "scorecardUUID": "scorecard_123",
  "teamUUIDs": [
    "team_123"
  ],
  "userUUIDs": [
    "user_123"
  ]
}' --json
```

## Example response

The static output schema is not detailed enough to generate a reliable example. Use `deepline tools get attention_get_scorecards_summary --json` for the complete live contract.

## Input reference

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

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.fromDateTime` | `string` | Yes | — | Start date and time for filtering scorecards (ISO 8601 format) Format: `date-time`. |
| `payload.toDateTime` | `string` | Yes | — | End date and time for filtering scorecards (ISO 8601 format) Format: `date-time`. |
| `payload.scorecardsItemsUUIDs` | `array` | Yes | — | — |
| `payload.scorecardUUID` | `string` | Yes | — | — |
| `payload.teamUUIDs` | `array` | Yes | — | — |
| `payload.userUUIDs` | `array` | Yes | — | — |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Retrieves detailed usage statistics for specified users or teams within a given time period.",
    "properties": {
      "fromDateTime": {
        "type": "string",
        "description": "Start date and time for filtering scorecards (ISO 8601 format)",
        "format": "date-time"
      },
      "toDateTime": {
        "type": "string",
        "description": "End date and time for filtering scorecards (ISO 8601 format)",
        "format": "date-time"
      },
      "scorecardsItemsUUIDs": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "scorecardUUID": {
        "type": "string"
      },
      "teamUUIDs": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "userUUIDs": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "required": [
      "fromDateTime",
      "scorecardUUID",
      "scorecardsItemsUUIDs",
      "teamUUIDs",
      "toDateTime",
      "userUUIDs"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.data` | `array` | Yes | — | Array of resources matching the query |
| `result.data.data[].overallScoreTotals` | `number` | Yes | — | — |
| `result.data.data[].min` | `number` | Yes | — | — |
| `result.data.data[].userName` | `string` | Yes | — | — |
| `result.data.data[].teamName` | `string` | Yes | — | — |
| `result.data.data[].metrics` | `array` | Yes | — | — |
| `result.data.data[].metrics[].overallScore` | `number` | Yes | — | — |
| `result.data.data[].metrics[].itemAverages` | `array` | Yes | — | — |
| `result.data.data[].metrics[].itemAverages[].title` | `string` | Yes | — | — |
| `result.data.data[].metrics[].itemAverages[].scorecardItemUUID` | `string` | Yes | — | — |
| `result.data.data[].metrics[].itemAverages[].average` | `number` | Yes | — | — |
| `result.data.data[].metrics[].itemAverages[].description` | `string` | No | — | — |
| `result.data.data[].metrics[].itemAverages[].evidence` | `array` | No | — | — |
| `result.data.data[].metrics[].itemAverages[].evidence[].quote` | `string` | No | — | — |
| `result.data.data[].metrics[].itemAverages[].evidence[].start_sec` | `number` | No | — | — |
| `result.data.data[].metrics[].itemAverages[].evidence[].end_sec` | `number` | No | — | — |
| `result.data.data[].metrics[].itemAverages[].evidence[].link` | `string` | No | — | Deep link to the conversation at the evidence timestamp |
| `result.data.data[].metrics[].date` | `string` | Yes | — | Format: `date-time`. |
| `result.data.data[].metrics[].entityInfo` | `object` | Yes | — | — |
| `result.data.data[].metrics[].entityInfo.uuid` | `string` | Yes | — | — |
| `result.data.data[].metrics[].entityInfo.title` | `string` | Yes | — | — |
| `result.data.data[].metrics[].conversationInfo` | `object` | No | — | — |
| `result.data.data[].metrics[].conversationInfo.teamUUID` | `string` | Yes | — | — |
| `result.data.data[].metrics[].conversationInfo.userUUID` | `string` | Yes | — | — |
| `result.data.data[].metrics[].conversationInfo.startedAt` | `string` | Yes | — | Format: `date-time`. |
| `result.data.data[].metrics[].conversationInfo.uuid` | `string` | Yes | — | — |
| `result.data.data[].metrics[].conversationInfo.title` | `string` | Yes | — | — |
| `result.data.data[].max` | `number` | Yes | — | — |
| `result.data.data[].itemAverageTotals` | `array` | Yes | — | — |
| `result.data.data[].itemAverageTotals[].title` | `string` | Yes | — | — |
| `result.data.data[].itemAverageTotals[].scorecardItemUUID` | `string` | Yes | — | — |
| `result.data.data[].itemAverageTotals[].average` | `number` | Yes | — | — |
| `result.data.data[].itemAverageTotals[].description` | `string` | No | — | — |
| `result.data.data[].itemAverageTotals[].evidence` | `array` | No | — | — |
| `result.data.data[].itemAverageTotals[].evidence[].quote` | `string` | No | — | — |
| `result.data.data[].itemAverageTotals[].evidence[].start_sec` | `number` | No | — | — |
| `result.data.data[].itemAverageTotals[].evidence[].end_sec` | `number` | No | — | — |
| `result.data.data[].itemAverageTotals[].evidence[].link` | `string` | No | — | Deep link to the conversation at the evidence timestamp |
| `result.data.data[].metricsCount` | `number` | Yes | — | — |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={null}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "data": {
            "type": "array",
            "description": "Array of resources matching the query",
            "items": {
              "type": "object",
              "properties": {
                "overallScoreTotals": {
                  "type": "number"
                },
                "min": {
                  "type": "number"
                },
                "userName": {
                  "type": "string"
                },
                "teamName": {
                  "type": "string"
                },
                "metrics": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "overallScore": {
                        "type": "number"
                      },
                      "itemAverages": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "title": {
                              "type": "string"
                            },
                            "scorecardItemUUID": {
                              "type": "string"
                            },
                            "average": {
                              "type": "number"
                            },
                            "description": {
                              "type": "string"
                            },
                            "evidence": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "quote": {
                                    "type": "string"
                                  },
                                  "start_sec": {
                                    "type": "number"
                                  },
                                  "end_sec": {
                                    "type": "number"
                                  },
                                  "link": {
                                    "type": "string",
                                    "description": "Deep link to the conversation at the evidence timestamp"
                                  }
                                },
                                "additionalProperties": false
                              }
                            }
                          },
                          "required": [
                            "average",
                            "scorecardItemUUID",
                            "title"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "date": {
                        "type": "string",
                        "format": "date-time"
                      },
                      "entityInfo": {
                        "type": "object",
                        "properties": {
                          "uuid": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "title",
                          "uuid"
                        ],
                        "additionalProperties": false
                      },
                      "conversationInfo": {
                        "type": "object",
                        "properties": {
                          "teamUUID": {
                            "type": "string"
                          },
                          "userUUID": {
                            "type": "string"
                          },
                          "startedAt": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "uuid": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "startedAt",
                          "teamUUID",
                          "title",
                          "userUUID",
                          "uuid"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "date",
                      "entityInfo",
                      "itemAverages",
                      "overallScore"
                    ],
                    "additionalProperties": false
                  }
                },
                "max": {
                  "type": "number"
                },
                "itemAverageTotals": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "title": {
                        "type": "string"
                      },
                      "scorecardItemUUID": {
                        "type": "string"
                      },
                      "average": {
                        "type": "number"
                      },
                      "description": {
                        "type": "string"
                      },
                      "evidence": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "quote": {
                              "type": "string"
                            },
                            "start_sec": {
                              "type": "number"
                            },
                            "end_sec": {
                              "type": "number"
                            },
                            "link": {
                              "type": "string",
                              "description": "Deep link to the conversation at the evidence timestamp"
                            }
                          },
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "average",
                      "scorecardItemUUID",
                      "title"
                    ],
                    "additionalProperties": false
                  }
                },
                "metricsCount": {
                  "type": "number"
                }
              },
              "required": [
                "itemAverageTotals",
                "max",
                "metrics",
                "metricsCount",
                "min",
                "overallScoreTotals",
                "teamName",
                "userName"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "data"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Attention provider guide](/docs/providers/attention/guide)
* [SDK V2 quickstart](/docs/sdk-v2/quickstart)
* [SDK reference](/docs/sdk-v2/sdk-reference)
* [Run tools across a CSV](/docs/sdk-v2/batch-csv)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.