---
title: "Time-bucketed usage per metered feature over a range"
method: GET
path: "/v1/billing/usage"
tags: ["billing"]
---

# Time-bucketed usage per metered feature over a range

`GET /v1/billing/usage`

## Query parameters

- `granularity` string
- `range` string
- `feature_id` string[], nullable

## Response `200`

Successful Response

- BillingUsageResponse — Time-bucketed usage per metered feature over a range. ``enabled=false`` mirrors the matrix kill-switch behavior. ``series`` is Autumn's per-bin list (each ``{period, values: {feature_id: n}}``); ``totals`` is the per-feature ``{count, sum}`` over the whole range. ``period`` is an epoch timestamp in Autumn's native unit — the frontend renders it as-is.
  - `enabled` boolean, required
  - `customer_id` string, nullable
  - `granularity` string, required
  - `range` string, required
  - `feature_ids` string[]
  - `series` object[]
  - `totals` object

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `422` — Validation Error

---

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