---
title: "Query usage metrics"
method: GET
path: "/data/usage/query"
tags: ["metrics"]
---

# Query usage metrics

`GET /data/usage/query`

## Query parameters

- `from` integer
- `to` integer
- `timeStep` 'hour' | 'day'
- `creatorId` string
- `breakdownBy[]` string[]

## Response `200`

A Usage Metric object

- UsageMetric — An individual metric about usage of a user.
  - `UserID` string — The user ID associated with the metric
  - `CreatorID` string — The creator ID associated with the metric
  - `DeliveryUsageMins` number — Total minutes of delivery usage.
  - `TotalUsageMins` number — Total transcoded minutes.
  - `StorageUsageMins` number — Total minutes of storage usage.

## Other responses

- `default` — Error

## Changes

- **2024-05-17** `fc477586b24c` — 6 breaking, 1 info
  - the response property `CreatorID` became optional for the status `200`
  - the response property `DeliveryUsageMins` became optional for the status `200`
  - the response property `StorageUsageMins` became optional for the status `200`
  - the response property `TotalUsageMins` became optional for the status `200`
  - …3 more
- **2024-04-23** `d0909f9b9414` — 2 info
  - api operation id `getUsageMetrics` was added
  - api tag `metrics` added

[Change history](https://skmtc.dev/livepeer/apis/livepeer-api-reference/changes/data/usage/query/get.md)

---

[API](https://skmtc.dev/livepeer/apis/livepeer-api-reference.md) · [All operations](https://skmtc.dev/livepeer/apis/livepeer-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/livepeer/livepeer-api-reference/revisions/0d7e15217608/schema)