Sign in

v1

latestOpenAPI 3.0.32026-08-0421040.6 KB
Verification

Verify a business entity by name in a specific jurisdiction. Returns verification results synchronously if available within timeout, or a job ID for async retrieval via GET /v1/verify/status/:jobId. Charges credits based on tier: quick (1 credit), deep (15 credits), deep + force_refresh (25 credits). The response includes full_verification_available indicating whether deep verification is supported for the jurisdiction. When deep is not available, a reason object is returned. When webhook_url is provided, the result is delivered as a POST request to that URL once the async job completes, fails, or is refunded.

post/v1/verify

Headers

idempotency-keystring

Optional key to make this request idempotent. Retries carrying the same key replay the original response instead of charging again; a concurrent retry while the first is still processing returns 409 IDEMPOTENCY_CONFLICT. Max 128 characters.

Request body

entity_namestring required

The business name to verify, e.g. "Acme Corporation"

jurisdictionstring required

Jurisdiction code, e.g. "us-fl" for Florida or "gb" for Great Britain

entity_type'llc' | 'corporation' | 'lp' | 'llp' | 'sole_proprietorship' | 'nonprofit' | 'general_partnership' | 'other'

Optional entity type filter to narrow results

verification_level'quick' | 'deep'

Verification tier: "quick" (1 credit) returns existence + status. "deep" (15 credits) returns full entity details including officers, registered agent, formation date, and filing history. Deep is only available in a subset of jurisdictions; requesting deep where unavailable returns a quick result with a reason.

force_refreshboolean

If true, returns the most current result instead of a previously stored one. Applies to deep verification only (cost: 25 credits instead of 15); ignored on quick verifications.

webhook_urlstring uri

Optional URL to receive webhook notifications when the async job completes, fails, or is refunded. Must be a publicly reachable http(s) URL.

Response

Default Response

statusstring required

Job status: "completed" (sync result) or "pending" (async — poll via GET /v1/verify/status/:jobId)

verification_level'quick' | 'deep' required

The tier at which verification was performed. May differ from the requested level if deep was requested but not available for this jurisdiction.

full_verification_availableboolean required

Whether deep verification is available for this jurisdiction

{"stackTrail":"paths:/v1/verify:post:responses:200:content:application/json:schema:properties:data","oasType":"schema","type":"unknown","description":"Verification result data, present when status is \"completed\""}
job_idstring

Job ID for async polling, present when status is "pending"

entity_idstring

Cached entity ID, present when a match was found

cachedboolean required

Whether the result was served from cache

credits_chargednumber required

Number of credits deducted for this request