---
title: "Get Dashboard"
method: GET
path: "/admin/api/v1/dashboard"
tags: ["Dashboard"]
---

# Get Dashboard

`GET /admin/api/v1/dashboard`

Return all five v1 dashboard widgets for the requested time range.

## Query parameters

- `range` '1h' | '24h' | '7d' | '30d' — Time-range filter values accepted by the dashboard endpoint.

## Response `200`

Successful Response

- DashboardResponse — Top-level dashboard payload returned by ``GET /admin/api/v1/dashboard``.
  - `range` '1h' | '24h' | '7d' | '30d', required — Time-range filter values accepted by the dashboard endpoint.
  - `generatedAt` string, date-time, required
  - `bucketSeconds` integer, required
  - `requests` RequestsBlock, required — Headline + series for the Requests widget.
    - `total` integer, required
    - `deltaPct` number, nullable
    - `series` TimeBucketPoint[]
      - `t` string, date-time, required
      - `v` number, required
  - `latency` LatencyBlock, required — Headline + series for the Latency p50 / p95 widget.
    - `p50Ms` number, nullable
    - `p95Ms` number, nullable
    - `p95DeltaPct` number, nullable
    - `series` LatencyBucketPoint[]
      - `t` string, date-time, required
      - `p50` number, nullable
      - `p95` number, nullable
  - `errorRate` ErrorRateBlock, required — Headline + series for the Error rate widget. ``value_pct`` is a decimal fraction (0.0042 means 0.42 %). ``delta_pp`` is a percentage-point delta as a decimal fraction (-0.001 means the error rate dropped by 0.1 pp; NOT a relative %).
    - `valuePct` number, required
    - `deltaPp` number, nullable
    - `series` TimeBucketPoint[]
      - `t` string, date-time, required
      - `v` number, required
  - `cost` CostBlock, required — Headline + series for the Total cost widget.
    - `totalUsd` number, required
    - `deltaPct` number, nullable
    - `series` TimeBucketPoint[]
      - `t` string, date-time, required
      - `v` number, required
  - `topErrors` TopErrorRow[]
    - `spanName` string, required
    - `count` integer, required
    - `lastSeen` string, date-time, required
    - `sampleTraceId` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/idun-group/apis/idun-agent-engine-server.md) · [All operations](https://skmtc.net/idun-group/apis/idun-agent-engine-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/idun-group/idun-agent-engine-server/revisions/8909cd73cc1c/schema)