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

# Get usage

`GET /v1/usage`

## Request

- Base URL: `https://api.aircaps.com`
- URL: `https://api.aircaps.com/v1/usage`
- Auth: HTTP bearer

Daily usage of each model your account can use.

## Query parameters

- `days` integer
- `timezone` string

## Response `200`

Usage report.

- Usage
  - `object` 'usage'
  - `timezone` string
  - `start_date` string, date
  - `end_date` string, date
  - `models` object[]
    - `id` string
    - `name` string
  - `daily` object[]
    - `date` string, date
    - `model` string
    - `requests` integer
    - `completed` integer
    - `failed` integer
    - `audio_seconds` number
  - `totals` object: Per model id.
  - `by_key` object[]
    - `key_id` string, nullable
    - `name` string
    - `model` string
    - `requests` integer
    - `audio_seconds` number

## Other responses

- `400`: Invalid query parameter (`param` names it). Codes: `invalid_request`.
- `401`: Missing or invalid API key. Codes: `unauthorized`.
- `403`: The account is disabled. Codes: `account_disabled`.
- `500`: Server error. Safe to retry (use the same Idempotency-Key). Codes: `internal_error`.
- `503`: Temporarily unavailable. Retry after the Retry-After interval. Codes: `service_unavailable`.

---

[API](https://skmtc.dev/aircaps/apis/aircaps-api.md) - [All operations](https://skmtc.dev/aircaps/apis/aircaps-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aircaps/apis/aircaps-api/revisions/442d566f9827?raw)