# Usage summary

> For the complete machine-readable documentation index, see [llms.txt](https://apidocs.chargebee.com/llms.txt).


Usage summary represents aggregated usage data for a metered [feature](/docs/api/features/feature-object) in a [subscription](/docs/api/subscriptions/subscription-object) over a specific reporting period. The aggregation is performed based on the [aggregation method](https://www.chargebee.com/docs/billing/2.0/usage-based-billing/defining-metered-features) configured in Billing.

Use this resource to analyze feature-level usage for reporting or analytics purposes, independent of usage billing or invoicing.

## Sample Usage-summary

```json
{
  "usage_summary": {
    "subscription_id": "sub-001",
    "feature_id": "storage",
    "aggregated_value": 350,
    "aggregated_from": 1762286390,
    "aggregated_to": 1762372708
  }
}
```

## Usage summary attributes

## Input Parameters

- `subscription_id` (required, string, max chars=50)
  The unique identifier of the subscription for which usage is reported.

- `feature_id` (required, string, max chars=100)
  The unique identifier of the metered feature for which usage is aggregated.

- `aggregated_value` (required, string, max chars=33)
  The total usage aggregated over the reporting window defined by `aggregated_from` and `aggregated_to`. The aggregation is performed based on the [aggregation method](https://www.chargebee.com/docs/billing/2.0/usage-based-billing/defining-metered-features) configured in Billing.

- `aggregated_from` (required, timestamp(UTC) in seconds)
  The start timestamp (inclusive) of the aggregation window in UTC.

- `aggregated_to` (required, timestamp(UTC) in seconds)
  The end timestamp (exclusive) of the aggregation window in UTC.