---
title: "Current/last month and all-time usage with plan limits"
method: GET
path: "/v1/usage"
tags: ["Usage"]
---

# Current/last month and all-time usage with plan limits

`GET /v1/usage`

## Request

- Base URL: `https://cold-api.coldstate.ai`
- URL: `https://cold-api.coldstate.ai/v1/usage`
- Auth: HTTP bearer

## Response `200`

OK

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate or quota limit exceeded

---

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