# The Meter Usage Analytics object

### The Meter Usage Analytics object

```json
{
  "object": "billing.analytics.meter_usage",
  "refreshed_at": 1735689000,
  "livemode": false,
  "rows": {
    "url": "/v1/billing/analytics/meter_usage",
    "has_more": false,
    "total": 3,
    "data": [
      {
        "object": "billing.analytics.meter_usage_row",
        "starts_at": 1733097600,
        "ends_at": 1733184000,
        "meter": "mtr_test_61Q8nQMqIFK9fRQmr41CMAXJrFdZ5MnA",
        "value": 1500,
        "dimensions": {
          "model": "gpt-4"
        }
      },
      {
        "object": "billing.analytics.meter_usage_row",
        "starts_at": 1733184000,
        "ends_at": 1733270400,
        "meter": "mtr_test_61Q8nQMqIFK9fRQmr41CMAXJrFdZ5MnA",
        "value": 2250,
        "dimensions": {
          "model": "gpt-4"
        }
      },
      {
        "object": "billing.analytics.meter_usage_row",
        "starts_at": 1733270400,
        "ends_at": 1733356800,
        "meter": "mtr_test_61Q8nQMqIFK9fRQmr41CMAXJrFdZ5MnA",
        "value": 1875,
        "dimensions": {
          "model": "gpt-4"
        }
      }
    ]
  }
}
```

## Attributes

- `object` (string)
  String representing the object’s type. Objects of the same type share the same value.

- `livemode` (boolean)
  Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

- `refreshed_at` (timestamp)
  The timestamp to indicate data freshness, measured in seconds since the Unix epoch.

- [`rows`](https://docs.stripe.com/api/billing/analytics/meter-usage/object.md?query=rows&api-version=2025-09-30.preview) (object)
  List of aggregate meter usage items, each with a start time, end time, value, and any meter or dimension details.