Usage & Billing

The Usage API provides access to your tenant's resource consumption — voice minutes, API calls, LLM tokens, and storage. Use it to monitor usage against your plan limits and build internal dashboards.

Usage Summary

Get a high-level overview of your current billing period:

cURL

curl "https://apps.aurionai.net/api/v1/usage/summary" \
  -H "X-API-Key: ak_live_xxxx"

Python

import requests

response = requests.get(
    "https://apps.aurionai.net/api/v1/usage/summary",
    headers={"X-API-Key": "ak_live_xxxx"},
)
usage = response.json()

Response:

{
  "period": {
    "start": "2026-03-01T00:00:00Z",
    "end": "2026-03-31T23:59:59Z"
  },
  "voice_minutes": {
    "used": 320,
    "limit": 1000,
    "percentage": 32.0
  },
  "api_calls": {
    "used": 12450,
    "limit": 50000,
    "percentage": 24.9
  },
  "storage_mb": {
    "used": 245,
    "limit": 5000,
    "percentage": 4.9
  },
  "plan": "professional",
  "billing_status": "active"
}

Detailed Usage

Get granular usage data with date range filtering and grouping:

curl "https://apps.aurionai.net/api/v1/usage/details?start_date=2026-03-01&end_date=2026-03-08&group_by=day" \
  -H "X-API-Key: ak_live_xxxx"

Query Parameters:

Parameter	Type	Description
`start_date`	string	Start date (ISO 8601)
`end_date`	string	End date (ISO 8601)
`group_by`	string	`day`, `week`, `month`
`event_type`	string	Filter: `voice`, `api`, `llm`, `storage`

Response:

{
  "data": [
    {
      "date": "2026-03-01",
      "voice_minutes": 45,
      "api_calls": 1850,
      "llm_tokens": {
        "input": 125000,
        "output": 42000
      }
    },
    {
      "date": "2026-03-02",
      "voice_minutes": 38,
      "api_calls": 1620,
      "llm_tokens": {
        "input": 98000,
        "output": 35000
      }
    }
  ]
}

Plan Tiers

Feature	Starter	Professional	Enterprise
Voice minutes	25/month	1,000/month	Unlimited
API calls	10,000/month	50,000/month	Unlimited
Seats	3	25	Unlimited
Storage	1 GB	5 GB	50 GB

Billing Alerts

The platform automatically generates alerts when usage approaches plan limits:

Alert	Trigger
Warning	80% of any quota reached
Critical	95% of any quota reached
Overage	Quota exceeded (service continues with overage charges)

Configure alert thresholds and notification channels in the admin dashboard under Billing > Alerts.

Billing Status

Status	Description
`active`	Normal operation
`past_due`	Payment overdue (7-day grace period)
`suspended`	Tenant suspended after grace period

Analytics — Conversation and SLA analytics
Environments — Rate limits per environment

Required Scope

API key requires the usage:read scope to access usage endpoints.

Usage & Billing

On this page