---
title: "Usage"
method: GET
path: "/v1/usage"
tags: ["usage"]
---

# Usage

`GET /v1/usage`

## Request

- Base URL: `https://api.dotwave.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dotwave.ai/v1/usage`
- Auth: none declared

## Query parameters

- `group_by` 'day' | 'model'
- `from` integer, nullable
- `to` integer, nullable

## Headers

- `authorization` string, nullable: `Bearer wk_…`: the project's API key (`Token` is an alias of `Bearer`). Create API keys in the console. New accounts start with $10 of credit; no card required.
- `x-api-key` string, nullable: The same API key, in place of the Authorization header.

## Response `200`

Successful Response

- UsageListResponse
  - `data` UsageGroupResponse[], required
    - `cost_usd` number, required
    - `key` string, required
    - `usage` UsageCountersResponse, required
      - `billable_seconds` number, required
      - `duplicate_frames` integer, required
      - `frames` integer, required
      - `late_frames` integer, required
      - `missing_frames` integer, required
      - `segments` integer, required
      - `symbols` integer, required
  - `group_by` 'day' | 'model', required
  - `object` 'list', required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/dotwave/apis/wave-live-api.md) - [All operations](https://skmtc.dev/dotwave/apis/wave-live-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dotwave/apis/wave-live-api/revisions/57e80b62c850?raw)