---
title: "EmployeeVerificationRequest.failed"
method: POST
path: "EmployeeVerificationRequest.failed"
tags: ["Webhook Events"]
---

# EmployeeVerificationRequest.failed

`POST EmployeeVerificationRequest.failed` (webhook)

Emitted when an Employee Verification Request has failed.

## Payload

- V1EmployeeVerificationRequestFailedWebhook
  - `__event__` WebhookMetadata
    - `type` 'BusinessSearch.submitted' | 'BusinessSearch.responded' | 'BusinessSearch.completed' | 'BusinessSearch.failed' | 'BusinessSearch.cancelled' | 'BusinessSearch.updated' | 'PersonSearch.submitted' | 'PersonSearch.completed' | 'PersonSearch.failed' | 'PersonSearch.updated' | 'DMFSearch.submitted' | 'DMFSearch.completed' | 'DMFSearch.failed' | 'LiensSearch.submitted' | 'LiensSearch.completed' | 'LiensSearch.failed' | 'LienFiling.created' | 'LienFiling.updated' | 'LienFiling.deleted' | 'DocketSearch.submitted' | 'DocketSearch.completed' | 'DocketSearch.failed' | 'DocketDetailsSearch.submitted' | 'DocketDetailsSearch.completed' | 'DocketDetailsSearch.failed' | 'DocketExhibitSearch.submitted' | 'DocketExhibitSearch.completed' | 'DocketExhibitSearch.failed' | 'APIKey.created' | 'APIKey.deleted' | 'OnboardingSession.completed' | 'Order.created' | 'RegistrationEnrichment.submitted' | 'RegistrationEnrichment.completed' | 'RegistrationEnrichment.failed' | 'NAICSPredictionRequest.submitted' | 'NAICSPredictionRequest.completed' | 'NAICSPredictionRequest.failed' | 'WebsiteAnalysisRequest.submitted' | 'WebsiteAnalysisRequest.completed' | 'WebsiteAnalysisRequest.failed' | 'WebPresenceRequest.submitted' | 'WebPresenceRequest.completed' | 'WebPresenceRequest.failed' | 'PortfolioItem.created' | 'PortfolioItem.updated' | 'PortfolioItem.deleted' | 'PortfolioGroup.created' | 'PortfolioGroup.updated' | 'PortfolioGroup.deleted' | 'TINVerification.submitted' | 'TINVerification.completed' | 'TINVerification.failed' | 'AdverseMediaSearch.submitted' | 'AdverseMediaSearch.completed' | 'AdverseMediaSearch.failed' | 'EmployeeVerificationRequest.submitted' | 'EmployeeVerificationRequest.completed' | 'EmployeeVerificationRequest.failed' | 'InternationalBusinessSearch.submitted' | 'InternationalBusinessSearch.completed' | 'InternationalBusinessSearch.failed', required — The canonical list of supported Webhook events. Every Webhook event sent via the notifier must be registered here. An exhaustive match is used against this enumeration to ensure that all events are valid and have corresponding rendering logic. @see WebhookNotifier.render_payload
    - `origin` 'api' | 'console' | 'mcp' | 'onboarding'
    - `organization_id` string, nullable
    - `application_id` string, nullable
    - `external_id` string, nullable
    - `application_type` string, nullable
  - `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.

## Acknowledgement `200`

Successful Response

- unknown

## 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)
