Verify existing business
Authorizations
Enter your API key in the format: sk_test_xxxxx or sk_live_xxxxx
Path Parameters
Body
Workflow key to use for verification. If not provided, uses organization default.
"business_verification_default"
Your reference ID for tracking this verification
"reverify_12345"
Additional metadata to attach to this verification
Response
Unique verification ID
"550e8400-e29b-41d4-a716-446655440000"
ID of the business entity created or verified
"bus_abc123"
Current status of the verification. Branch on this before reading risk or match:
completed— Terminal. Either a confident match (populatedmatch, evaluatedrisk.level) OR a "no match" verdict (emptymatch: {},risk.level: criticalwith"Business not found"reason).in_progress— Not yet resolved.risk.levelisnull,matchis{}. Final outcome delivered viabusiness.verification.completedwebhook. Causes include async LLM disambiguation, status acquisition from live Secretary-of-State, or routing to manual review.failed— System error. Safe to retry.pending— Created but not yet started (rare; transient).
pending, in_progress, completed, failed "completed"
Test/live partition the verification was created under. Determined by the API key used.
test, live "live"
Business risk assessment. Only meaningful when status: completed. See BusinessVerificationRisk.level for the three response shapes (matched / no-match / pending).
Field-level match results against the matched authoritative record. Empty object {} in two cases: (1) terminal "no match" outcome (status: completed, risk.level: critical) where no record was identified; (2) async-pending outcome (status: in_progress) where verification hasn't resolved yet — wait for the webhook. When populated, only includes fields the partner submitted in the request.
ISO 8601 timestamp of when the verification was created
"2025-10-24T10:30:00Z"
Your reference ID (if provided in request)
"biz_12345"
Associated people verification results (full KYC results for each associate)
ISO 8601 timestamp of when the verification was last updated
"2025-10-24T10:35:00Z"

