Skip to main content
GET /api/v1/usage Returns your current tier, billing period, rate limits, and usage counters (monthly requests, WebSocket connections/subscriptions). Use this to monitor quota consumption and understand your tier’s capabilities. A value of 0 for any limit field means unlimited.

Response

tier
string
Current tier: free, pro, or scale.
billing_period_start
integer
Unix seconds — 1st of current month UTC.
billing_period_end
integer
Unix seconds — 1st of next month UTC.
limits
object
Tier limits for this account.
usage
object
Current measured usage for this billing period.
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.parsecapi.com/api/v1/usage"
{
  "tier": "pro",
  "billing_period_start": 1772524800,
  "billing_period_end": 1775203200,
  "limits": {
    "monthly_requests": 100000,
    "rest_qps": 10,
    "rest_qps_burst": 20,
    "ws_max_subscriptions": 50,
    "ws_max_depth": 20,
    "history_max_age_days": 30
  },
  "usage": {
    "monthly_requests": 4237,
    "ws_active_connections": 2,
    "ws_active_subscriptions": 8
  }
}
Use /api/v1/ws/usage when you need the more detailed WebSocket telemetry breakdown by market or customer scope.