---
title: "List metered API usage"
method: GET
path: "/api/v1/billing/usage"
tags: ["Billing"]
---

# List metered API usage

`GET /api/v1/billing/usage`

## Request

- Base URL: `https://api.esheria.ai`
- URL: `https://api.esheria.ai/api/v1/billing/usage`
- Auth: API key in header `x-api-key`

## Query parameters

- `token_id` string, nullable
- `endpoint_family` string, nullable
- `pack_id` string, nullable
- `date_from` string, nullable
- `date_to` string, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: Unauthorized
- `402`: Credits exhausted
- `409`: Conflict
- `422`: Validation error
- `503`: Billing or dependency unavailable

---

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