---
title: "AI Assistant Usage API endpoints"
description: "Endpoint reference for the AI Assistant Usage tag (1 endpoints): What the in-product AI assistant chat cost each user, for invoicing"
type: "reference"
audience: [network-manager, admin]
keywords: [api, rest, endpoints, ai, assistant, usage]
---

Fetch the complete documentation index at: https://epom.com/ad-server/docs/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# AI Assistant Usage API endpoints

What the in-product AI assistant chat cost each user, for invoicing. 1 endpoint, generated from the OpenAPI spec. Authentication, the response envelope, pagination and error codes are shared by all endpoints — see [REST API overview](https://epom.com/ad-server/docs/api.md). Parameters marked `form` go in an `application/x-www-form-urlencoded` request body.

### GET /rest-api/ai-chat/usage.do

[Request examples](https://epom.com/ad-server/docs/api/ai-assistant-usage/get-ai-chat-usage.md)

Get AI assistant usage for a month.

| Parameter | In | Type | Required | Description |
|---|---|---|---|---|
| `month` | query | string | no | Calendar month (UTC) in YYYY-MM form; the current month when omitted |

**Responses:** `200` — {success, month, rows:[{userId, username, keySource, calls, inputTokens, outputTokens, cacheReadTokens, cacheWriteTokens, rawCostUsd, billedCostUsd, promoWaivedUsd, limitUsd}], totalRawUsd, totalBilledUsd, totalPromoWaivedUsd, multiplier, promoUntil, promoAllowanceUsd}. Errors follow the [shared conventions](https://epom.com/ad-server/docs/api.md#error-codes).

## Related

- [REST API overview](https://epom.com/ad-server/docs/api.md) — authentication and conventions
- [API endpoint reference by tag](https://epom.com/ad-server/docs/api/endpoints.md)

<!-- Generated from the OpenAPI spec. Do not edit by hand. -->