---
title: "Current monthly usage for the authenticated entity"
method: GET
path: "/api/v1/usage"
tags: ["Usage"]
---

# Current monthly usage for the authenticated entity

`GET /api/v1/usage`

## Request

- Base URL: `https://www.agenttax.io`
- URL: `https://www.agenttax.io/api/v1/usage`
- Auth: one of:
  - HTTP bearer
  - none

Returns calls-this-month and percent-of-tier-limit per product, plus an upgrade_prompt block when the entity is at or approaching its tier limit. Demo mode returns a free-tier stub with usage: 0.

## Response `200`

Usage summary.

## Other responses

- `401`: Authentication required.
- `429`: Rate limited.

---

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