# The Meter Usage Analytics object

## 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` (object)
  List of aggregate meter usage items, each with a start time, end time, value, and any meter or dimension details.

  - `rows.data` (array of objects)
    The aggregated meter usage data for the specified customer and time range.

    - `rows.data.id` (string)
      Unique identifier for the object.

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

    - `rows.data.dimensions` (object, nullable)
      A set of key-value pairs representing the dimensions of the meter usage.

    - `rows.data.ends_at` (timestamp)
      Timestamp indicating the end of the bucket. Measured in seconds since the Unix epoch.

    - `rows.data.meter` (string, nullable)
      The unique identifier for the meter. Null if no meters were provided and usage was aggregated across all meters.

    - `rows.data.starts_at` (timestamp)
      Timestamp indicating the start of the bucket. Measured in seconds since the Unix epoch.

    - `rows.data.value` (float)
      The aggregated meter usage value for the specified bucket.

  - `rows.has_more` (boolean)
    The value is `true` if this list has another page of items to fetch.

  - `rows.total` (integer)
    The total number of items across all pages.

  - `rows.url` (string)
    The URL where you can access this list.

### 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"
        }
      }
    ]
  }
}
```