Authentication

All API requests require an API key passed via the X-API-Key header.

curl https://frontrun.vc/v1/status \
  -H "X-API-Key: your_api_key"

Getting an API key

Sign up or log in at frontrun.vc (opens in a new tab)
Navigate to Developer > API Keys
Click Create Key
Copy and store your key - it will not be displayed again

Usage

Billable calls draw on your plan's monthly usage, shared across chat, outreach, enrichment and the API:

Subscribe - Pro ($99/mo, pay upfront) includes API + MCP access and monthly usage. Max ($199/mo) has 4x the usage of Pro. Usage resets each billing period.
Top up - Buy a Small, Medium or Large top-up pack via the developer page. Top-ups never expire.

Calls use your monthly usage first, then any top-up. Check how much you have used anytime with GET /v1/status.

Full pricing →

Error responses

401 Unauthorized

{
  "error": "Missing X-API-Key header",
  "docs": "https://frontrun.vc/docs/api"
}

The X-API-Key header is missing, or the key is invalid or inactive.

402 Payment Required

{
  "error": "out_of_usage",
  "error_code": "out_of_usage",
  "message": "You're out of usage for this month. Upgrade to Max for 4x the usage of Pro, or top up.",
  "usage_pct": 100,
  "usage_resets_at": "2026-11-01T00:00:00Z",
  "plan": "pro",
  "upgrade": "https://frontrun.vc/pricing",
  "top_up": "https://frontrun.vc/api/billing"
}

You are out of usage for this period. Upgrade, top up (or enable auto-refill), or wait for the reset.

Security

API keys are bearer tokens. Treat them as secrets.
Do not expose keys in client-side code, public repositories, or browser requests.
Rotate keys immediately if compromised via your dashboard.
All API traffic is encrypted over HTTPS.

Introduction Use Cases