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

# Get API usage

`GET /usage`

## Request

- Base URL: `https://app.colacloud.us/api/v1`
- URL: `https://app.colacloud.us/api/v1/usage`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Get current usage statistics for your account.
Shows detail view and list record consumption, limits, and tier information.

## Response `200`

Successful response

- object
  - `data` UsageStats
    - `tier` 'free' | 'starter' | 'pro': Your account tier
    - `current_period` string: Current billing period (YYYY-MM)
    - `detail_views` UsageQuota: Usage quota for a single meter
      - `used` integer: Amount used this period
      - `limit` integer: Maximum allowed this period
      - `remaining` integer: Amount remaining this period
    - `list_records` UsageQuota: Usage quota for a single meter
      - `used` integer: Amount used this period
      - `limit` integer: Maximum allowed this period
      - `remaining` integer: Amount remaining this period
    - `per_minute_limit` integer: Maximum requests per minute (burst limit)

## Other responses

- `401`: Missing or invalid API key or Bearer token

---

[API](https://skmtc.dev/colacloud/apis/cola-cloud-api.md) · [All operations](https://skmtc.dev/colacloud/apis/cola-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/colacloud/apis/cola-cloud-api/revisions/1cb00a02112c?raw)