---
title: "TINVerification.submitted"
method: POST
path: "TINVerification.submitted"
tags: ["Webhook Events"]
---

# TINVerification.submitted

`POST TINVerification.submitted` (webhook)

Emitted when a TIN verification has been submitted for processing.

## Payload

- V1TINVerificationSubmittedWebhook
  - `__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 unique identifier of the TIN verification request.
  - `state` 'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED', required
  - `name` string, required — The name inputted in the search.
  - `tin` string, required — The TIN inputted in the search.
  - `address` string, nullable — The address inputted in the search.
  - `tin_matched` boolean, nullable — Indicates whether the inputted TIN/EIN was a match, per the IRS.
  - `warnings` string[] — Any warnings that occurred.
  - `created_at` string, date-time, required — The date and time when the TIN verification request was created.
  - `tin_match_type` 'SSN' | 'EIN' | 'UNKNOWN'

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