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

# On-Demand Reports

> Generate usage reports using natural language queries. Describe the chart or breakdown you need, and the system builds it for you.

On-Demand Reports lets you query your Telnyx usage data using natural language. Instead of building filters and exporting CSVs, describe the report you want in plain English and the system generates it.

***

## Overview

On-Demand Reports uses AI to translate natural language into structured queries against your [Usage Report](/docs/reporting/usage-reports/index) data. You can request specific chart types, date ranges, groupings, and breakdowns — all from a single text input.

***

## Getting started

1. Log in to the [Mission Control Portal](https://portal.telnyx.com).
2. Navigate to **Reporting** > **[On-Demand Reports](https://portal.telnyx.com/#/reporting/on-demand-reports)**.
3. Type a query describing the report you need and submit it.

<img src="https://mintcdn.com/telnyx/CK2IQbzSNcAAKyBl/img/on-demand-reports-interface.png?fit=max&auto=format&n=CK2IQbzSNcAAKyBl&q=85&s=9d46a27d7c53622e0f622c592cac3f68" alt="On-Demand Reports query interface" width="1194" height="454" data-path="img/on-demand-reports-interface.png" />

***

## Example queries

* "Daily wireless spend for the last 10 days"
* "Number of messages by direction for last week as a pie chart"
* "Weekly total calls last quarter"
* "Average SIP cost for last 2 weeks as line graph"
* "SIP usage for the last month as a table"

***

## What you can do

| Capability                   | Description                                                                |
| ---------------------------- | -------------------------------------------------------------------------- |
| **Natural language queries** | Describe reports in plain English instead of building filters manually     |
| **Chart type selection**     | Request bar charts, pie charts, line graphs, or tabular breakdowns         |
| **Date range control**       | Specify relative ("last 10 days") or absolute ("in February") time periods |
| **Grouping and breakdowns**  | Group data by direction, product, day, week, or other dimensions           |

***

## Current limitations

* Queries run against **v2 Usage Report data** only. Products and dimensions available in Usage Reports are available here.
* **Not a general knowledge assistant** — the system answers questions about your Telnyx usage data, not general questions.
* This is the first release. Coverage and capabilities will expand over time.