---
title: "Translation usage"
method: GET
path: "/ai/v1/usage"
tags: ["AI"]
---

# Translation usage

`GET /ai/v1/usage`

## Request

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

Get translation usage for the current billing period.

## Response `200`

Usage data

- AiUsageResponse
  - `translation` object, required
    - `active` boolean, required
    - `used_words` integer, required
    - `included_words` integer, required
    - `remaining_words` integer, required
    - `billing_cycle_start` string, date-time, nullable, required

## Other responses

- `401`: Missing or invalid authentication. Run402-originated JSON bodies use the canonical ErrorEnvelope.

---

[API](https://skmtc.dev/run402/apis/run402-api.md) · [All operations](https://skmtc.dev/run402/apis/run402-api/llms.txt) · [OpenAPI document](https://skmtc.dev/run402/apis/run402-api/revisions/893607557f50?raw)