---
title: "Period rollup: totals, day buckets, per-agent grouping"
method: GET
path: "/reporting/summary"
---

# Period rollup: totals, day buckets, per-agent grouping

`GET /reporting/summary`

## Request

- Base URL: `https://getsanction.com/api/v1`
- URL: `https://getsanction.com/api/v1/reporting/summary`
- Auth: one of:
  - API key in header `x-api-key`
  - API key in header `x-mgmt-key`

REPORT-1: the daily summary over any range up to 92 days (defaults to the last 7). Totals for spend/decisions/tokens/secret access, a day-by-day series, and group_by=agent for the per-seat breakdown. Membership-gated like the other reporting surfaces.

## Query parameters

- `wallet_id` string, required
- `from` string, date
- `to` string, date
- `group_by` 'agent'
- `scope` 'wallet' | 'subtree'

## Response `200`

Totals + days[] (+ by_agent[] when grouped)

## Other responses

- `400`: Invalid range (reversed, malformed, or over 92 days)
- `401`: Management key or wallet agent key required

---

[API](https://skmtc.dev/getsanction/apis/sanction-agent-governance-api.md) · [All operations](https://skmtc.dev/getsanction/apis/sanction-agent-governance-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getsanction/apis/sanction-agent-governance-api/revisions/c645a9e4b72d?raw)