---
title: "Get usage snapshot"
method: GET
path: "/usage/v1"
tags: ["Usage"]
---

# Get usage snapshot

`GET /usage/v1`

Returns customer-facing usage metrics and costs for the requested period. Supports summary totals and daily buckets for timestamped usage sources. Vault storage is intentionally omitted from totals because it is not yet periodized for arbitrary windows.

## Query parameters

- `periodStart` string, date-time
- `periodEnd` string, date-time
- `granularity` 'summary' | 'daily'

## Response `200`

Usage snapshot retrieved successfully

## Other responses

- `400` — Invalid query parameters
- `401` — Invalid API key or session
- `403` — Insufficient permissions

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/revisions/5b7e64e6d6f9/schema)