> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aui.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage

> Interaction and token metrics per agent or across a project.

Usage endpoints report **metrics** — interaction counts and token volume — for
one agent or aggregated across a project, over a time window you choose.

***

## Get usage

```bash cURL theme={"dark"}
curl "https://api-v3.aui.io/apollo-api/management/v1/agents/{agentId}/usage?created_from=2026-07-01T00:00:00Z&created_to=2026-07-13T00:00:00Z" \
  -H "x-organization-api-key: <org_api_key>"
```

### GET `/management/v1/agents/{agentId}/usage`

### GET `/management/v1/projects/{projectId}/usage`

Same parameters and response for both — the project variant aggregates across
every agent in the project.

#### Query parameters

<ParamField query="created_from" type="string">
  Start of the usage window (RFC 3339). Omit for no lower bound.
</ParamField>

<ParamField query="created_to" type="string">
  End of the usage window (RFC 3339). Omit for no upper bound.
</ParamField>

#### Response

<ResponseField name="interaction_count" type="integer">
  Number of interactions in the window.
</ResponseField>

<ResponseField name="input_tokens" type="integer">
  Total input tokens.
</ResponseField>

<ResponseField name="output_tokens" type="integer">
  Total output tokens.
</ResponseField>

<ResponseField name="cache_read_tokens" type="integer">
  Total cached (read) input tokens.
</ResponseField>

<ResponseField name="reasoning_tokens" type="integer">
  Total reasoning tokens.
</ResponseField>

<ResponseField name="total_tokens" type="integer">
  Sum of input, output, cache-read, and reasoning tokens.
</ResponseField>

<ResponseExample>
  ```json 200 theme={"dark"}
  {
    "interaction_count": 1284,
    "input_tokens": 512400,
    "output_tokens": 98211,
    "cache_read_tokens": 240100,
    "reasoning_tokens": 15320,
    "total_tokens": 866031
  }
  ```
</ResponseExample>