---
title: "AI tokens an App spent (v2, tenant actor)"
method: GET
path: "/v2/apps/{appId}/ai-usage"
tags: ["Apps"]
---

# AI tokens an App spent (v2, tenant actor)

`GET /v2/apps/{appId}/ai-usage`

## Request

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

Model tokens charged to the App from the daily ledger: agent replies, the
smart gate, heartbeat turns, flow answers, the agent reply API, and the
embeddings for Web Index pages, uploaded documents and knowledge search.
`from`/`to` are UTC days, `to` exclusive; the default is the current month
to date. `monthToDate` is always included.

## Path parameters

- `appId` string, required

## Query parameters

- `from` string, date
- `to` string, date

## Response `200`

```
{ ok: true, result: { appId, from, to, monthToDate,
  total: { calls, inputTokens, outputTokens, totalTokens, estimatedTokens, chatTokens, embeddingTokens },
  byKind: [{ kind, ... }], byAgent: [{ agentId, ... }], byModel: [{ model, ... }], byDay: [{ date, ... }] } }
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: validation error
- `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)