Skip to main content
POST
Start Employee Verification Request

Authorizations

X-API-Key
string
header
required

Headers

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.

business_name
string
required

Name of the business to check against.

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.

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.