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

# Subscription usage

> Monitor and track subscription service consumption and allowances

Subscription usage tracking provides real-time visibility into service consumption for active telecommunications subscriptions. It enables monitoring of data usage, voice minutes, SMS messages, and other service allowances to support billing, customer notifications, and service management.

## Usage Entity

Subscription usage in the Connect API represents:

* **Real-time Tracking**: Current period consumption of data, voice, SMS, and other services
* **Allowance Monitoring**: Usage relative to subscription plan limits and allowances
* **Billing Integration**: Usage data for billing calculations and overage charges
* **Notification Support**: Usage thresholds for customer alerts and service warnings

## Key Capabilities

<Columns cols={2}>
  <Card title="Current Usage" icon="chart-line">
    View real-time consumption of data, voice, and SMS services for active
    subscriptions.
  </Card>

  <Card title="Allowance Tracking" icon="gauge">
    Monitor usage against subscription plan allowances and remaining balances.
  </Card>

  <Card title="Multi-Subscription View" icon="grid-2">
    Retrieve usage data for multiple subscriptions simultaneously for bulk
    operations.
  </Card>

  <Card title="Period Tracking" icon="calendar">
    Track usage within billing periods for accurate billing and reporting.
  </Card>
</Columns>

## Common Use Cases

<Columns cols={2}>
  <Card title="Usage Monitoring" icon="monitor">
    Enable customers to track their service consumption in real-time through
    self-service portals.
  </Card>

  <Card title="Overage Prevention" icon="bell">
    Send notifications when customers approach usage limits to prevent
    unexpected charges.
  </Card>

  <Card title="Billing Accuracy" icon="calculator">
    Provide accurate usage data for billing calculations and invoice generation.
  </Card>

  <Card title="Service Analytics" icon="chart-pie">
    Analyze usage patterns for service optimization and product recommendations.
  </Card>
</Columns>

## Related Resources

Subscription usage integrates with other Connect API resources:

* **Subscriptions**: Base subscriptions for which usage is tracked
* **Invoices**: Usage data included in customer billing statements
* **Product Offerings**: Plan allowances defining usage limits
* **Webhooks**: Usage threshold events for proactive customer notifications
* **Top-ups**: Usage monitoring to identify top-up opportunities

## Next Steps

<CardGroup cols={2}>
  <Card title="Get Subscription Usage" icon="chart-simple" href="/api-reference/subscription-usage/get-subscription-usage">
    Retrieve current usage for a specific subscription
  </Card>

  <Card title="Get Multiple Usage" icon="chart-mixed" href="/api-reference/subscription-usage/get-subscriptions-usage">
    Get usage data for multiple subscriptions at once
  </Card>
</CardGroup>