---
title: "This key's month-to-date consumption"
method: GET
path: "/v1/agent/usage"
---

# This key's month-to-date consumption

`GET /v1/agent/usage`

## Request

- Base URL: `https://api.fundz.net`
- URL: `https://api.fundz.net/v1/agent/usage`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fundz/apis/fundz-agent-data-api/docs/v1/agent/usage/get.ts> (a function with typed inputs; its response is checked against the schema)

Units consumed this calendar month by the calling key.

## Response `200`

Success.

- UsageResponse
  - `key_id` string
  - `tier` string
  - `units_month_to_date` string
  - `unit_allowance` string
  - `rate_per_minute` string
  - `indicative_usd_month_to_date` string

## Other responses

- `400`: The request body is not valid JSON, or a parameter is unusable.
- `401`: No API key, or a key that is unknown, revoked or expired. A human must supply a new key; retrying will not help.
- `402`: The key's monthly unit allowance is spent. Valid key, exhausted plan — a plan change, not a new key.
- `403`: The tool exists but this key's tier may not call it.
- `404`: No such tool. Check the spelling before checking permissions.
- `429`: Per-minute rate limit exceeded. Back off and retry.
- `500`: Our fault. The call is recorded at ZERO units — we do not bill for our own failures.

---

[API](https://skmtc.dev/fundz/apis/fundz-agent-data-api.md) - [All operations](https://skmtc.dev/fundz/apis/fundz-agent-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fundz/apis/fundz-agent-data-api/revisions/52b70c238bce?raw)