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

# DMFSearch.failed

`POST DMFSearch.failed` (webhook)

Emitted when a Death Master File search has failed.

## Payload

- V1DMFSearchFailedWebhook
  - `__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 — The ID of the DMF search request
  - `name` string, required — The name of the person of interest
  - `ssn` string, required — The obfuscated social security number of the person of interest
  - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
  - `error` string, nullable — Any errors that occurred during the DMF search request.
  - `user` V1UserAttributionResponse — Response model for user attribution operations. This model defines the structure for user attribution API responses.
    - `id` string, uuid, required — Unique identifier for the user.
    - `first_name` string, required — First name of the user.
    - `last_name` string, required — Last name of the user.
    - `email` string, required — Email address of the user.

## 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/versions/0cc89938bc26/schema)