Integration Guide - TIN Discovery

In this guide you'll learn how to use TIN Discovery registrations with subscribed businesses on Middesk's Identity Platform.

TIN's associated with new businesses will sometimes be unverifiable and yield an unknown status when they are initially verified through Middesk's TIN match due to data lag in the IRS's TIN matching program. It's typical to request documentation from businesses when the TIN returns an unknown status.

TIN Discovery provides an alternative approach that seamlessly attempts to re-verify a business's TIN without further friction imposed on the customer. TIN Discovery attempts to verify the businesses TIN multiple times up to 14 days after the initial TIN Match attempt is ordered.

📘

When running businesses with unknown TIN through TIN Discovery, Middesk found 87% of TINs within 14 days for newly formed businesses less than 1 year old.

Before getting started

• Work with our Sales Team to enable Monitoring on your account
• Ensure that you can authenticate against the Middesk API, create businesses and ingest Middesk results via Webhooks (Integration Guide)

TIN Discovery runs checks on a set cadence for 2 weeks to find TINs for businesses whose were previously unknown. TIN Discovery will continue to run until

Tin Discovery Lifecycle

Here's the typical lifecycle of a business with monitoring enabled:

1. Business created via Create a Business endpoint.
2. Business is subscribed to TIN Discovery
3. A TIN verification is attempted at 1, 3, 7 and 14 days after subscribed
4. A webhook event is sent to registered webhook endpoint(s) if a TIN verification if a new TIN status is found.
5. The client application ingests and evaluates the change in the business record

Step 1: Submit a business

You need to submit a business for business verification prior to

NOTE: The business must have a TIN property included in the request body in the tin field.

Step 2: Subscribe a business

You can enable monitoring on Middesk businesses using 4 different strategies. Work with your account manager to determine the best strategy for your specific use-case.

Automatic Monitoring Subscription

All businesses can be automatically subscribed when a Business Verification order completes.

Policy Action

Policies provides a rule-based system for automation within the Middesk platform. A custom policy Action can be used to subscribe Middesk businesses when certain conditions are met.

Via API

Use the Monitor API to create, update and delete business monitors via the Middesk REST api interface for fine-grained control within your application.

Via Dashboard

You can manually enable monitoring on a Business with a completed business verification order via the Monitoring tab.