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.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.
Overview
On-Demand Reports uses AI to translate natural language into structured queries against your Usage Report data. You can request specific chart types, date ranges, groupings, and breakdowns — all from a single text input.Getting started
- Log in to the Mission Control Portal.
- Navigate to Reporting > On-Demand Reports.
- Type a query describing the report you need and submit it.

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.