---
title: "Start Employee Verification Request"
method: POST
path: "/employee_verification_requests"
tags: ["Employee Verification"]
---

# Start Employee Verification Request

`POST /employee_verification_requests`

Start a new employee verification request.

## Headers

- `Prefer` string, nullable — 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.

## Request body

- V1EmployeeVerificationRequest
  - `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, nullable — Business address for disambiguation.
  - `alternative_names` string[], nullable — Alternative names for the business (e.g., DBA names).

## Response `201`

Response

- V1EmployeeVerificationRequestResponse
  - `id` string, uuid, required — ID of the employee verification request.
  - `created_at` string, date-time, required — When the request was created.
  - `updated_at` string, date-time, nullable — When the request was last updated.
  - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
  - `person_name` string, required — Full name of the person being verified.
  - `business_name` string, required — Name of the business being checked.
  - `business_address` string, nullable — Business address provided for disambiguation.
  - `alternative_names` string[], nullable — Alternative names provided for the business.
  - `verified` boolean, nullable — Whether the person was verified as an employee.
  - `role_title` string, nullable — Job title or role, if discovered.
  - `department` string, nullable — Department, if discovered.
  - `evidence_summary` string, nullable — Summary of evidence found.
  - `contact` EmployeeVerificationContact
    - `email` string, nullable — Email address.
    - `phone` string, nullable — Phone number.
  - `socials` EmployeeVerificationSocial[], nullable — Social media profiles discovered for the person.
    - `platform` 'linked_in:personal' | 'linked_in:company' | 'twitter' | 'instagram' | 'facebook' | 'youtube' | 'tiktok' | 'pinterest' | 'x', required
    - `url` string, required — Profile URL.
  - `miscellaneous_links` EmployeeVerificationMiscLink[], nullable — Other web links found for the person (e.g. GitHub, personal site).
    - `label` string, required — Description of the link (e.g. 'GitHub profile', 'Personal website').
    - `url` string, required — URL.
  - `sources` EmployeeVerificationSource[], nullable — Sources consulted during verification.
    - `url` string, required — URL of the source.
    - `description` string, required — What this source says about the person.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/baselayer/apis/baselayer-api-service.md) · [All operations](https://skmtc.net/baselayer/apis/baselayer-api-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baselayer/baselayer-api-service/revisions/0cc89938bc26/schema)