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

# Get AI usage

`GET /ai/usage`

## Request

- Base URL: `https://osis.co/api/v1/comms`
- URL: `https://osis.co/api/v1/comms/ai/usage`
- Auth: HTTP bearer

How many AI tokens you've used this period. No plan includes AI tokens. Scope: `comms_ai`.

## Response `200`

Usage summary

- object
  - `usage` object
    - `used` integer
    - `included` integer, nullable
    - `remaining` integer, nullable
    - `planKey` string
    - `planName` string
    - `usageBilled` boolean
    - `rates` object
      - `inputUsdPerMillion` number
      - `outputUsdPerMillion` number
    - `models` string[]

## Other responses

- `401`: API key is missing or wrong
- `403`: Your key doesn't have the scope this needs

---

[API](https://skmtc.dev/osis/apis/comms-api.md) · [All operations](https://skmtc.dev/osis/apis/comms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/osis/apis/comms-api/revisions/59a4c0ba8936?raw)