---
title: "Analytics — AVCodex Docs"
description: "Analytics — AVCodex documentation for AV integrators, programmers, and ops teams."
lang: en
json-ld:
---

[](/)

Solutions

[Pricing](/pricing)[The Signal](/blog)[Resources](/resources)

Learn

[Free AI Assessment](/scorecard)[Get Started →](/pricing)

[Documentation Home](/docs)

Guides 

Custom Actions 

Pro Actions 

API 

Builder API 

-   [Overview](/docs/builder-api/overview)
-   [Sessions](/docs/builder-api/sessions)
-   [Consumers](/docs/builder-api/consumers)
-   [Feedback](/docs/builder-api/feedback)
-   [Tags](/docs/builder-api/tags)
-   [Knowledge Sources](/docs/builder-api/knowledge-sources)
-   [Memories](/docs/builder-api/memories)
-   [Analytics](/docs/builder-api/analytics)

Agentic Commerce (ACP) 

Integrations 

[Docs](/docs)/ Builder API / Builder API 

# Analytics

Last updated · MAR 2026 · [Read as Markdown](/docs/builder-api/analytics.md)

The analytics endpoints provide aggregate data on how your agent is being used: session counts, message volume, consumer growth, and token consumption broken down by model. Useful for tracking adoption across a dealer program or measuring how often field techs are using the agent.

## [Usage analytics# ](#usage-analytics)

code 

```
GET /api/v1/apps/{appId}/analytics/usage
```

Returns a usage summary with a timeseries breakdown.

### [Query parameters# ](#query-parameters)

Parameter

Type

Default

Description

`started_after`

ISO 8601

none (all time)

Start of the date range.

`started_before`

ISO 8601

none (all time)

End of the date range.

`group_by`

string

`day`

Timeseries granularity: `day`, `week`, `month`.

### [Example# ](#example)

bash 

```
curl "https://app.avcodex.com/api/v1/apps/YOUR_APP_ID/analytics/usage?started_after=2025-06-01T00:00:00Z&group_by=day" \
  -H "Authorization: Bearer avcodex_YOUR_API_KEY"
```

### [Response# ](#response)

json 

```
{
  "data": {
    "summary": {
      "total_sessions": 1247,
      "unique_consumers": 342,
      "total_messages": 8934
    },
    "timeseries": [
      {
        "period": "2025-06-01T00:00:00.000Z",
        "session_count": 45,
        "message_count": 312
      },
      {
        "period": "2025-06-02T00:00:00.000Z",
        "session_count": 52,
        "message_count": 387
      }
    ]
  }
}
```

### [Response fields# ](#response-fields)

**Summary**

Field

Type

Description

`total_sessions`

integer

Total sessions in the date range.

`unique_consumers`

integer

Distinct consumers who started a session.

`total_messages`

integer

Total messages sent and received.

**Timeseries entries**

Field

Type

Description

`period`

ISO 8601

Start of the time bucket.

`session_count`

integer

Sessions in this period.

`message_count`

integer

Messages in this period.

### [Weekly grouping# ](#weekly-grouping)

bash 

```
curl "https://app.avcodex.com/api/v1/apps/YOUR_APP_ID/analytics/usage?group_by=week&started_after=2025-01-01T00:00:00Z" \
  -H "Authorization: Bearer avcodex_YOUR_API_KEY"
```

* * *

## [Token usage# ](#token-usage)

code 

```
GET /api/v1/apps/{appId}/analytics/token-usage
```

Returns token consumption totals, broken down by model. Useful for tracking spend and understanding which models the agent relies on.

### [Query parameters# ](#query-parameters)

Parameter

Type

Default

Description

`started_after`

ISO 8601

none (all time)

Start of the date range.

`started_before`

ISO 8601

none (all time)

End of the date range.

### [Example# ](#example)

bash 

```
curl "https://app.avcodex.com/api/v1/apps/YOUR_APP_ID/analytics/token-usage?started_after=2025-06-01T00:00:00Z" \
  -H "Authorization: Bearer avcodex_YOUR_API_KEY"
```

### [Response# ](#response)

json 

```
{
  "data": {
    "total": {
      "input_tokens": 2450000,
      "output_tokens": 1230000,
      "total_tokens": 3680000,
      "request_count": 4521
    },
    "by_model": [
      {
        "model": "gpt-4.1",
        "input_tokens": 1200000,
        "output_tokens": 600000,
        "total_tokens": 1800000,
        "request_count": 2100
      },
      {
        "model": "claude-sonnet-4-20250514",
        "input_tokens": 1250000,
        "output_tokens": 630000,
        "total_tokens": 1880000,
        "request_count": 2421
      }
    ]
  }
}
```

### [Response fields# ](#response-fields)

**\`total\` object**

Field

Type

Description

`input_tokens`

integer

Total prompt/input tokens consumed.

`output_tokens`

integer

Total completion/output tokens consumed.

`total_tokens`

integer

Sum of input and output tokens.

`request_count`

integer

Total number of LLM requests.

**Per-model breakdown (\`by\_model\` entries)**

Field

Type

Description

`model`

string

Model identifier.

`input_tokens`

integer

Input tokens for this model.

`output_tokens`

integer

Output tokens for this model.

`total_tokens`

integer

Total tokens for this model.

`request_count`

integer

Number of LLM requests for this model.

\*AVCodex · Your AV expertise. Amplified by AI.\*

Was this helpful? 

[Edit this page →](#)

[

Previous

Memories

](/docs/builder-api/memories)[

Next

Overview

](/docs/acp/overview)

On this page

-   [Usage analytics](#usage-analytics)
-   [Query parameters](#query-parameters)
-   [Example](#example)
-   [Response](#response)
-   [Response fields](#response-fields)
-   [Weekly grouping](#weekly-grouping)
-   [Token usage](#token-usage)
-   [Query parameters](#query-parameters)
-   [Example](#example)
-   [Response](#response)
-   [Response fields](#response-fields)

[](/)

The AI platform built exclusively for professional AV. Build, deploy, and sell AI tools that understand your industry.

### Platform

-   What You Can Build
-   Templates
-   [Pricing](/pricing)

### Services

-   [Done-For-You](/pricing)
-   [Academy](/academy)
-   [Contact](/contact)

### Company

-   About
-   [The Signal](/blog)
-   [Docs](/docs)
-   [LinkedIn](#)

© 2026 AVCodex. A Future Ready Holdings Inc. product. SOC 2 Type II Certified · HIPAA Compliant