---
title: "AI tokens an agent used this month (owner only)"
method: GET
path: "/v2/agents/{idOrAddress}/ai-usage"
tags: ["Agents"]
---

# AI tokens an agent used this month (owner only)

`GET /v2/agents/{idOrAddress}/ai-usage`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/agents/{idOrAddress}/ai-usage`
- Auth: HTTP bearer

Tokens charged to this agent this UTC month, across every App it answers in,
by kind (replies, reply checks, scheduled messages, flow answers, the agent
reply API, Web Index / document indexing, knowledge search), and last month's
total for comparison.

## Path parameters

- `idOrAddress` string, required

## Response `200`

`{ ok: true, result: { agentId, month, monthToDate, byKind: [{ kind, totalTokens, calls }], lastMonth } }`

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: not the agent's owner
- `404`: no such agent
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

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