telnesstech

Subscription usage

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.

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