# Get all tenant usage for this month
curl "https://api.arkhq.io/v1/usage/tenants" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Sort by highest volume with pagination
curl "https://api.arkhq.io/v1/usage/tenants?sort=-sent&page=1&perPage=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Filter active tenants with activity
curl "https://api.arkhq.io/v1/usage/tenants?status=active&minSent=100" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "tenantId": "cm6abc123def456",
      "tenantName": "Acme Corp",
      "externalId": "acme_123",
      "status": "active",
      "emails": {
        "sent": 10000,
        "delivered": 9700,
        "soft_failed": 100,
        "hard_failed": 50,
        "bounced": 100,
        "held": 50
      },
      "rates": {
        "delivery_rate": 0.97,
        "bounce_rate": 0.015
      }
    },
    {
      "tenantId": "cm6def789ghi012",
      "tenantName": "Beta Inc",
      "externalId": null,
      "status": "active",
      "emails": {
        "sent": 5000,
        "delivered": 4850,
        "soft_failed": 50,
        "hard_failed": 30,
        "bounced": 50,
        "held": 20
      },
      "rates": {
        "delivery_rate": 0.97,
        "bounce_rate": 0.016
      }
    }
  ],
  "page": 1,
  "perPage": 50,
  "total": 150,
  "totalPages": 3,
  "period": {
    "start": "2024-01-01T00:00:00.000Z",
    "end": "2024-01-31T23:59:59.999Z"
  },
  "summary": {
    "totalTenants": 150,
    "totalSent": 500000,
    "totalDelivered": 485000
  },
  "meta": {
    "requestId": "req_abc123xyz"
  }
}