# Get dashboard overview

`GET /dashboard/v1/overview`

Call metrics between `start_at` and `end_at`, grouped by `granularity` and optionally narrowed with `agent_id` and `source`.

## Auth

Authentication required.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| start_at | query | yes | string | Inclusive ISO-8601 start |
| end_at | query | yes | string | Inclusive ISO-8601 end |
| granularity | query | no | string |  |
| timezone | query | no | string |  |
| agent_id | query | no | string |  |
| source | query | no | string |  |

## Request body

No request body.

## Responses

| Status | Description | Content-Type | Shape |
|---|---|---|---|
| 200 | Successful Response | application/json | unknown |
| 422 | Validation Error | application/json | HTTPValidationError |

## Machine-readable

This page is also available as Markdown at `/docs/get-dashboard-v1-overview.md` (the ".md" suffix convention). The full curated API contract is at `/api/openapi.json`, and a machine-readable index of every page is at `/llms.txt`.