---
title: "Get plan usage summary"
method: GET
path: "/usage"
tags: ["Usage"]
---

# Get plan usage summary

`GET /usage`

Retrieve the organization's plan minutes consumption for the current
    billing period — the same numbers shown by the dashboard usage bar.

    Returns the minutes included in the plan, the minutes already used,
    the minutes remaining from the quota, the extra minutes consumed beyond
    the quota, and the billing period bounds. Internal credit rates and
    pricing details are intentionally omitted.

    Authentication:
    - API key with READ or READ_WRITE permission, or
    - OAuth access token granted the `usage:read` scope

## Response `200`

Successfully retrieved plan usage summary

- object
  - `ok` boolean
  - `data` object

## Other responses

- `401` — Invalid or missing API key
- `403` — Insufficient permissions
- `404` — Resource not found

---

[API](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1.md) · [All operations](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yourang/yourang-ai-external-api-v1/versions/49680ee64400/schema)