---
title: "Get Usage Timeseries"
method: GET
path: "/v1/orgs/{org_id}/usage/timeseries"
tags: ["organizations"]
---

# Get Usage Timeseries

`GET /v1/orgs/{org_id}/usage/timeseries`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/orgs/{org_id}/usage/timeseries`
- Auth: none declared

Daily aggregates from `usage_events` for the consumption chart.

Buckets by calendar date in the requested IANA timezone (DST-aware via
Mongo's `$dateToString` `timezone` arg). Returns exactly `days` points,
zero-filling any date with no events. p95 latency is computed via
Mongo's t-digest `$percentile` aggregator.

## Path parameters

- `org_id` string, required

## Query parameters

- `days` integer
- `tz` string: IANA timezone (e.g. America/Toronto)

## Response `200`

Successful Response

- OrgUsageTimeseriesOut
  - `tz` string, required
  - `points` OrgUsageTimeseriesPoint[], required
    - `date` string, required
    - `billable_units` integer, required
    - `free_calls` integer, required
    - `errors` integer, required
    - `p95_latency_ms` number, nullable, required

## Other responses

- `422`: Validation Error

---

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