Overview

Track your validation quota consumption in real-time. See how many validations you’ve used, how many remain, when the quota resets, and receive alerts when approaching limits.

How It Works

1. Usage is tracked per billing cycle (daily for Free, monthly for paid)
2. Dashboard shows:
– Validations used / remaining
– Team seats used / available
– Monitored URLs used / limit
– Projects used / limit
3. API endpoint provides real-time usage data
4. Team members share the account owner’s quota

Tier Availability

All tiers.

Related Features

– Plan Tiers & Limits: Defines the quota limits
– Stripe Subscription Management: Upgrade to increase limits
– Team Seats: Team members consume shared quota

Mini-Tutorial

Step 1: Check Your Usage

On the dashboard, your quota gauge shows validations used/remaining for the current period.

Step 2: Understand Resets

– Free: Quota resets daily at midnight UTC (5 validations/day)
– Paid: Quota resets monthly on your billing date (e.g., 1,000 validations for Pro)

Step 3: Monitor Shared Quota

All team members share the same quota pool. If one member uses 300 validations, only 700 remain for the whole team.

Step 4: Alert Thresholds

Go to Settings > Alerts and enable notifications when you reach 75% or 90% of your quota.

Step 5: Upgrade Before Running Out

If approaching the limit, upgrade your plan before quota runs out. You’ll get more validations immediately.

Step 6: Track Team Consumption

In Team Members, you can see individual member validation counts to identify high users.

Technical Details

Get Current Usage

GET /api/v1/usage

Response:

{
  "plan": "pro",
  "billing_cycle": {
    "start_date": "2025-03-01",
    "end_date": "2025-03-31",
    "days_remaining": 9,
    "percent_elapsed": 70.97
  },
  "usage": {
    "validations": {
      "used": 523,
      "limit": 1000,
      "remaining": 477,
      "percent_used": 52.3,
      "daily_average": 74.7
    },
    "projects": {
      "used": 3,
      "limit": 5,
      "remaining": 2
    },
    "team_seats": {
      "used": 1,
      "limit": 1,
      "remaining": 0
    },
    "monitored_urls": {
      "used": 0,
      "limit": 0,
      "remaining": 0
    }
  },
  "projections": {
    "estimated_usage_by_end": 750,
    "will_exceed": false,
    "upgrade_recommended": false
  },
  "team_breakdown": [
    {
      "member": "[email protected]",
      "validations_used": 400,
      "percent_of_total": 76.5
    }
  ]
}

Usage Alert Thresholds

Set in Settings > Alerts:

POST /api/v1/alert-settings
{
  "quota_alerts": {
    "enabled": true,
    "thresholds": [75, 90],
    "email": "[email protected]"
  }
}

When usage reaches 75%, admin receives:

Subject: ValidGraph - 75% quota used this month
Body: You've used 750 of 1000 validations. 250 remain.
Upgrade or reduce usage to avoid hitting the limit.

Validation Cost

Each validation (regardless of source) counts as 1:
– Single URL validation: 1
– Bulk upload (N URLs): N
– API validation request: 1
– Automated rescans: 1 per URL
– Plugin publish validation: 1

Quota Overage Handling

If you exceed quota:
– Free tier: New validations blocked until reset (5/day limit strict)
– Pro/Agency: Still accepts validations but next billing cycle includes overage charges
– Enterprise: Unlimited, no overage

Upgrade Impact on Quota

When you upgrade mid-cycle:

Before: Pro (1K/month), used 500, remaining 500 on day 15 of 30
Upgrade to: Agency (10K/month)
After: Agency limit (10K) applied immediately, remaining ~9500

Remaining quota from old plan is forfeit; new quota applies immediately.

References

– Usage-Based Billing Models
– Quota and Rate Limiting
– Fair-Use and Quota Policies
– ValidGraph Usage API