This request returns AI usage totals for a period: requests, units consumed (TTS characters, audio minutes, LLM tokens), failure rate and latency. Telecom X staff (ADMIN and RESELLER_ADMIN) additionally receive cost in USD/DKK and a linear projection of the current month's cost.
Results are scoped by access level: Telecom X staff (ADMIN and RESELLER_ADMIN) see everything and may filter freely; white label resellers (RESELLER) are locked to their own customer tree; everyone else is locked to their own customer.
| URL | https://api.telecomx.dk/ai/usage/summary | |
|---|---|---|
| Method | GET | |
| Access level | MANAGER (scoped, see above) | |
| Query | from | Start of period, ISO date. |
| to | End of period, ISO date. | |
| customer | [optional] Only usage for this customer id. |
|
| reseller | [optional] Only usage under this reseller id (uses the reseller tree). |
|
| service | [optional] TTS, STT or LLM. |
|
| context | [optional] AUDIO_FILE, TTS_STREAM, STT_API, VOICEMAIL, RECORDING_TRANSCRIPTION, RECORDING_SUMMARY or UNKNOWN. |
|
https://api.telecomx.dk/ai/usage/summary?from=2026-08-01&to=2026-08-12 https://api.telecomx.dk/ai/usage/summary?from=2026-08-01&to=2026-08-12&service=STT
| Property | Type | Description |
|---|---|---|
| requests | Number | Total number of AI requests in the period. |
| services | Object | Per-service stats, keys TTS, STT, LLM. |
| services.*.requests | Number | Requests for the service. |
| services.*.failed | Number | Requests with status FAILED. |
| services.*.aborted | Number | Requests with status ABORTED (client hung up). |
| services.*.timeout | Number | Requests with status TIMEOUT (concurrency limit). |
| services.*.avgTtfbMs | Number | Average time to first byte in ms, null when unknown. |
| ttsCharacters | Number | TTS input characters. |
| ttsAudioMinutes | Number | Generated TTS audio minutes. |
| sttAudioMinutes | Number | Transcribed audio minutes (file duration). |
| inputTokens | Number | LLM input tokens. |
| outputTokens | Number | LLM output tokens. |
| failedPct | Number | (FAILED + TIMEOUT) / requests as percentage, 2 decimals. Aborts are not counted. |
| p95TtfbMs | Number | 95th percentile TTS time to first byte in ms. Null when no TTS data or when filtering on another service. |
| costUSD | Number | [ADMIN/RESELLER_ADMIN only] Total cost in USD. |
| costDKK | Number | [ADMIN/RESELLER_ADMIN only] Total cost in DKK (exchange rate frozen per record at write time). |
| projectedMonthCostDKK | Number | [ADMIN/RESELLER_ADMIN only] Linear projection of the current calendar month's total cost in DKK. |
| Error code | Message | Description |
|---|---|---|
| 400 | validation | Invalid or missing query parameters |
| 403 | access_denied | Insufficient access level |
| 500 | internal_error | <Unspecified> |