Usage Analytics

GET /api/v1/meters/<meter_id>/usage?group_by=day&start_date=2025-01-01&end_date=2025-01-31

{
  "meter_id": "550e8400-...",
  "total_usage": 82450,
  "event_count": 12300,
  "unique_customers": 47,
  "period_start": "2025-01-01T00:00:00Z",
  "period_end": "2025-01-31T23:59:59Z",
  "grouped_data": [
    {
      "period": "2025-01-01",
      "usage": 2800,
      "event_count": 420
    }
  ]
}

GET /api/v1/meters/<meter_id>/stats

{
  "meter_id": "...",
  "total_events": 1250000,
  "unique_customers": 342,
  "first_event_date": "2024-06-01T00:00:00Z",
  "last_event_date": "2025-01-31T23:59:00Z",
  "today_usage": 4200,
  "this_week_usage": 28100,
  "this_month_usage": 82450
}

GET /api/v1/customers/<customer_id>/usage

GET /api/v1/meters/<meter_id>/events?page=1&page_size=50

{
  "data": [
    {
      "id": "...",
      "customer_id": "...",
      "meter_id": "...",
      "quantity": "100",
      "ingested_at": "2025-01-15T10:30:00Z",
      "idempotency_key": "req_123",
      "meta_data": { "region": "us-east-1" }
    }
  ],
  "meta": {
    "page": 1,
    "page_size": 50,
    "total": 12300,
    "total_pages": 246
  }
}