Quickstart

1. Get an API key

   Send your email to get a one-time verification code:

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

   Check your inbox for the 6-digit code, then exchange it for an API 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": "my-app"}'

   Response:

   {
     "api_key": "bv_live_abc123...",
     "key_id": "key_xyz",
     "label": "my-app"
   }

   Caution

   Store your API key securely. It is shown only once.

2. Verify a business

   cURL

   curl -X POST https://api.bizverify.co/v1/verify \
     -H "Content-Type: application/json" \
     -H "X-API-Key: bv_live_abc123..." \
     -d '{"entity_name": "Acme Corporation", "jurisdiction": "us-fl"}'

   Node.js

   import { BizVerify } from '@bizverify/sdk';
   
   const biz = new BizVerify({ apiKey: 'bv_live_abc123...' });
   const result = await biz.verification.verify({
     entity_name: 'Acme Corporation',
     jurisdiction: 'us-fl',
   });

   Python

   from bizverify import BizVerify
   
   client = BizVerify(api_key="bv_live_abc123...")
   result = client.verification.verify("Acme Corporation", "us-fl")

   If the result is cached, you get an immediate response with status: "completed". Otherwise, you get status: "pending" with a job_id.

3. Poll for results (if async)

   If you received a job_id, poll until the job completes:

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

   Response when complete:

   {
     "status": "completed",
     "job_id": "job_abc123",
     "entity_id": "ent_xyz",
     "data": {
       "entity_name": "ACME CORPORATION",
       "entity_type": "corporation",
       "status": "active",
       "jurisdiction": "us-fl",
       "formation_date": "2015-03-12",
       "confidence": 95
     }
   }

   Tip

   Use webhooks instead of polling to get notified when a job completes.

Credit costs

Operations cost between 1-25 credits. Entity lookups and job status checks are free. See Credits & Billing for the full pricing table.

Next steps

• Authentication — API keys, key management
• Credits & Billing — Credit costs and purchasing
• Async Jobs — Polling, webhooks, and the job lifecycle
• Error Codes — Handle errors gracefully
• Jurisdiction Coverage — All supported jurisdictions
• MCP Setup — Use BizVerify from AI tools
• OpenAPI Spec — Machine-readable API schema
• API Reference — Full endpoint documentation