# Current month usage
curl "https://api.arkhq.io/v1/tenants/cm6abc123def456/usage" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Specific month
curl "https://api.arkhq.io/v1/tenants/cm6abc123def456/usage?period=2024-01" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Custom date range
curl "https://api.arkhq.io/v1/tenants/cm6abc123def456/usage?period=2024-01-01..2024-01-15" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "tenant_id": "cm6abc123def456",
    "tenant_name": "Acme Corp",
    "external_id": "acme_123",
    "period": {
      "start": "2024-01-01T00:00:00.000Z",
      "end": "2024-01-31T23:59:59.999Z"
    },
    "emails": {
      "sent": 10000,
      "delivered": 9700,
      "soft_failed": 100,
      "hard_failed": 50,
      "bounced": 100,
      "held": 50
    },
    "rates": {
      "delivery_rate": 0.97,
      "bounce_rate": 0.015
    }
  },
  "meta": {
    "requestId": "req_abc123xyz"
  }
}