GET /v1/status
Returns your tier, which discovery lanes and scopes your key may use, tracked account count, how much of this period's monthly usage you have used, when it resets, and a 30-day call breakdown.
Cost: Free
curl https://frontrun.vc/v1/status \
-H "X-API-Key: your_api_key"Response
{
"tier": "pro",
"mcp_access": true,
"lanes": { "people": true, "accelerators": false },
"scopes": { "network": true, "lists": true },
"tracked_accounts": 12,
"usage": {
"used_pct": 38,
"resets_at": "2026-11-01T00:00:00Z",
"paused": false,
"unlimited": false
},
"usage_30d": {
"total_calls": 347,
"by_operation": {
"follows_new": { "calls": 280 },
"track_setup": { "calls": 12 },
"convergence": { "calls": 30 },
"follows_snapshot": { "calls": 25 }
}
}
}Response fields
| Field | Type | Description |
|---|---|---|
tier | string | Your subscription tier: free, pro, or enterprise. |
mcp_access | boolean | Whether your plan includes MCP access. |
lanes | object | Which discovery lanes this key may call: people (GET /v1/people and the people webhook event), accelerators (GET /v1/accelerators and the accelerators event). false means those calls answer 403 lanes_not_enabled. |
scopes | object | network: whether scope=network is open to this key; lists: whether scope=list:<id> and /v1/lists are. |
tracked_accounts | integer | Number of accounts currently being monitored. |
usage | object | used_pct (0-100) is how much of this period's monthly usage is used; resets_at is when it resets; paused is true when usage is used up (calls return 402 until reset, upgrade or top-up); unlimited is true on Enterprise. |
usage_30d | object | Calls in the last 30 days, grouped by operation. |