---
title: Subscription usage
description: Monitor and track subscription service consumption and allowances
---

Subscription usage shows what an active telecom subscription consumed. It covers the data,
the voice minutes, the SMS messages, and the other allowances. Billing, customer
notifications, and service management all read these numbers.

## Usage entity

Subscription usage in the 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

- **Current usage** — View real-time consumption of data, voice, and SMS services for active subscriptions.
- **Allowance tracking** — Monitor usage against subscription plan allowances and remaining balances.
- **Multi-subscription view** — Retrieve usage data for multiple subscriptions simultaneously for bulk operations.
- **Period tracking** — Track usage within billing periods for accurate billing and reporting.

## Common use cases

- **Usage monitoring** — A customer reads their own consumption in your self-service portal.
- **Overage prevention** — Send notifications when customers approach usage limits to prevent unexpected charges.
- **Billing accuracy** — Provide accurate usage data for billing calculations and invoice generation.
- **Service analytics** — Analyze usage patterns for service optimization and product recommendations.

## Related resources

Subscription usage integrates with other 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
- **Topups**: Usage monitoring to identify topup opportunities

## Next steps

- [Get subscription usage](/api-reference/subscription-usage.md#tag/subscription-usage/GET/subscriptions/{subscriptionId}/usage) — Retrieve current usage for a specific subscription
- [Get multiple usage](/api-reference/subscription-usage.md#tag/subscription-usage/GET/subscriptions/usage) — Get usage data for multiple subscriptions at once