Skip to main content
POST
Start Employee Verification Request

Authorizations

X-API-Key
string
header
required

Headers

Idempotency-Key
string | null

An opaque key, ideally a UUID, that makes this request safe to retry. A second request with the same key, path, query and body answers with the resource the first one created, marked Idempotent-Replayed: true, instead of creating another; a sync request that finds it still running waits for it. The same key with a different request is refused with 422. Keys are scoped to your application and to this resource type, and are kept for the life of the resource.

Prefer
string | null

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.

Example:

"respond-async"

Body

application/json

The request containing person and business details to verify employment.

person_name
string
required

Full name of the person to verify.

Required string length: 1 - 512
business_name
string
required

Name of the business to check against.

Required string length: 1 - 512
business_address
string | null

Business address for disambiguation.

alternative_names
string[] | null

Alternative names for the business (e.g., DBA names).

Maximum array length: 10

Response

Response

id
string<uuid>
required

ID of the employee verification request.

created_at
string<date-time>
required

When the request was created.

state
enum<string>
required

Current state of the request.

Available options:
PENDING,
EXECUTING,
COMPLETED,
FAILED,
CANCELLED
person_name
string
required

Full name of the person being verified.

business_name
string
required

Name of the business being checked.

updated_at
string<date-time> | null

When the request was last updated.

idempotency_key
string | null

The Idempotency-Key header the request that created this resource carried, if any.

business_address
string | null

Business address provided for disambiguation.

alternative_names
string[] | null

Alternative names provided for the business.

verified
boolean | null

Whether the person was verified as an employee.

role_title
string | null

Job title or role, if discovered.

department
string | null

Department, if discovered.

evidence_summary
string | null

Summary of evidence found.

contact
EmployeeVerificationContact · object | null

Contact information discovered for the person.

socials
EmployeeVerificationSocial · object[] | null

Social media profiles discovered for the person.

Other web links found for the person (e.g. GitHub, personal site).

sources
EmployeeVerificationSource · object[] | null

Sources consulted during verification.