---
title: "Get Usage"
method: GET
path: "/v1/admin/usage"
tags: ["beta.admin.billing"]
---

# Get Usage

`GET /v1/admin/usage`

Get usage and cost data for the Organization.

## Query parameters

- `month` string, nullable — Month to return usage for.
- `year` string, nullable — Year to return usage for.
- `workspace_id` string, uuid, nullable — Workspace ID to filter results.
- `api_zone` 'global' | 'us' | 'eu'

## Response `200`

OK

- UsageOUTJSON
  - `completion` BasicModelUsageDataJSON, required
    - `models` object, required — Usage data grouped by model.
  - `ocr` BasicModelUsageDataJSON, required
    - `models` object, required — Usage data grouped by model.
  - `connectors` BasicModelUsageDataJSON, required
    - `models` object, required — Usage data grouped by model.
  - `libraries_api` LibrariesAPIUsageDataJSON, required
    - `pages` BasicModelUsageDataJSON, required
      - `models` object, required — Usage data grouped by model.
    - `tokens` BasicModelUsageDataJSON, required
      - `models` object, required — Usage data grouped by model.
    - `audio_seconds` BasicModelUsageDataJSON, required
      - `models` object, required — Usage data grouped by model.
  - `fine_tuning` FineTuningDataJSON, required
    - `training` object, required — Fine-tuning training usage.
    - `storage` object, required — Fine-tuning storage usage.
  - `audio` BasicModelUsageDataJSON, required
    - `models` object, required — Usage data grouped by model.
  - `audio_characters` BasicModelUsageDataJSON, required
    - `models` object, required — Usage data grouped by model.
  - `vibe_usage` number, required — Current Vibe usage amount.
  - `chat` BasicModelUsageDataJSON, required
    - `models` object, required — Usage data grouped by model.
  - `date` string, date-time, required — Reference date for the usage period.
  - `previous_month` string, nullable, required — Previous month in the usage report.
  - `next_month` string, nullable, required — Next month in the usage report.
  - `start_date` string, date-time, required — Start of the usage period.
  - `end_date` string, date-time, required — End of the usage period.
  - `currency` string, nullable, required — Currency used for usage prices.
  - `currency_symbol` string, nullable, required — Currency symbol used for usage prices.
  - `prices` PriceData[], nullable, required — Prices used to calculate usage amounts.
    - `event_type` 'api_tokens' | 'api_pages' | 'api_audio_seconds' | 'api_audio_characters' | 'api_connectors' | 'api_libraries_tokens' | 'api_libraries_pages' | 'api_libraries_audio' | 'deployment_tokens' | 'gpu_hour' | 'reserved_instance' | 'vibe_tokens' | 'vibe_connectors' | 'vibe_pages' | 'vibe_audio_seconds' | 'vibe_audio_characters', required
    - `billing_metric` string, required — Billing metric this price applies to.
    - `billing_group` string, required — Billing metric group this price applies to.
    - `api_zone` 'global' | 'us' | 'eu', required
    - `price` union, required — Unit price for the billing metric.
      - number
      - string

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)