---
name: usage
description: Reports data consumption, burn rate, projected depletion date, roaming country history, and usage anomalies. Use when the operator asks how much data a subscriber has used, when they will run out, or whether any consumption looks abnormal.
argument-hint: "[subscriber/MSISDN] [period]"
---

# Usage

Report and forecast data consumption.

- **current usage** → `subscriber_usage` for the subscriber/period in `$ARGUMENTS`.
- **projection** → `usage_projection` to forecast depletion and recommend top-up timing.
- **depletion / network events** → `subscriber_depletion_events`, `subscriber_network_events`.
- **travel pattern** → `subscriber_country_history` (which networks/countries the SIM has roamed).
- **anomalies** → `detect_usage_anomalies` across the fleet to catch runaway consumption or fraud.

Summarize: used vs allotment, burn rate, projected depletion date, and a clear recommendation (top up, upsize, throttle, or no action). Flag anything anomalous prominently.
