Usage & Limits

Each customer has a plan with monthly usage limits. Check current usage and remaining capacity with GET /gating/status.

Checking usage

curl https://api.totalview.energy/api/v1/gating/status \
  -H "Authorization: Bearer $TOKEN"

{
  "customer_id": "…",
  "plan_type": "premium",
  "gating_disabled": false,
  "monthly_existing_mw_limit": 10000.0,
  "monthly_future_run_limit": 1000,
  "existing_mw_used": 2500.0,
  "existing_mw_remaining": 7500.0,
  "future_runs_used": 2,
  "future_runs_remaining": 998
}

How limits work

Usage is measured over a rolling 30-day window and tracked separately for the two product surfaces:

Surface	Tracks	Limit field
Existing projects (High-Impact Reporting)	MW of existing capacity analyzed	monthly_existing_mw_limit
Future projects (High-Impact Procurement)	Number of model runs	monthly_future_run_limit

monthly_run_limit / monthly_mw_limit are legacy combined limits, superseded by the separate counters above.

When a limit is exceeded, queue requests are rejected until usage falls back within the window. Check *_remaining before submitting large batches. Enterprise plans may have gating_disabled: true.

Next steps

• Quickstart · Batch Processing · API Reference