---
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

## Response `200`

A Usage Metric object

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

## Other responses

- `default` — Error

## Changes

- **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/d0909f9b9414/schema)