---
title: "Bucketed usage over time (gap-filled)"
method: GET
path: "/v1/usage/timeseries"
tags: ["usage"]
---

# Bucketed usage over time (gap-filled)

`GET /v1/usage/timeseries`

## Request

- Base URL: `https://api.ditto.audio` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ditto.audio/v1/usage/timeseries`
- Auth: HTTP bearer

One point per hour or day across the whole window — idle buckets are returned as zeros so charts do not interpolate across quiet periods.

## Query parameters

- `bucket` 'hour' | 'day'

## Response `200`

---

[API](https://skmtc.dev/ditto/apis/ditto-audio-api.md) · [All operations](https://skmtc.dev/ditto/apis/ditto-audio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ditto/apis/ditto-audio-api/revisions/30c8d7c218da?raw)