Authentication

Getting an API key

BizVerify uses a passwordless flow. No password needed — just your email.

1. Request access

curl -X POST https://api.bizverify.co/v1/auth/request-access \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com", "accept_terms": true}'

A 6-digit verification code is sent to your email (valid for 15 minutes). If the email is new, an account is created with 50 free credits.

2. Verify and get your key

curl -X POST https://api.bizverify.co/v1/auth/verify-access \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com", "code": "123456", "label": "production"}'

The label is optional — if omitted, a label like key-1712000000 is generated. You can create multiple keys with different labels.

Using your API key

Include the key in the X-API-Key header on every request:

curl https://api.bizverify.co/v1/account \
  -H "X-API-Key: bv_live_abc123..."

Key management

Create additional keys

curl -X POST https://api.bizverify.co/v1/account/keys \
  -H "Content-Type: application/json" \
  -H "X-API-Key: bv_live_abc123..." \
  -d '{"label": "CI/CD"}'

View your keys

Your API keys are included in the account response:

curl https://api.bizverify.co/v1/account \
  -H "X-API-Key: bv_live_abc123..."

The api_keys array in the response shows each key’s id, label, prefix (first 8 chars), rate_limit, is_active, and created_at.

Revoke a key

curl -X DELETE https://api.bizverify.co/v1/account/keys/key_xyz \
  -H "X-API-Key: bv_live_abc123..."

Credits

See Credits & Billing for credit costs, balance tracking, and purchasing.

Rate limits

API key requests are rate-limited to 60 requests/minute by default. See Rate Limits for headers, error handling, and best practices.