For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact SalesGet Support
HomeGuidesAPI reference
HomeGuidesAPI reference
  • Get started
    • Quickstart—Verify a Business
    • Quickstart—Register an entity for payroll taxes
    • Learn how Middesk works
    • Security
    • Changelog
  • Build with Middesk
    • Get your API keys
    • Understand API changes
    • Status codes and errors reference
    • Implement webhooks
    • Secure webhooks
    • Use GraphQL
    • Connect MCP
  • Verify a business (KYB)
    • Verify TIN
      • Monitor TINs for newly formed businesses
      • TIN review tasks
    • Verify name and address
    • Verify Secretary of State status
    • Verify owners and officers
    • Screen for sanctions and watchlists
    • Search for adverse media
    • Search for Politically Exposed Persons
    • Implement KYC
    • Discover connections
    • Evaluate online presence
    • Assess credit risk
    • Accelerate onboarding
    • Monitor business activity
    • Manage business entities
    • Work with agents
LogoLogo
Contact SalesGet Support
On this page
  • TIN Discovery lifecycle
  • Enable TIN monitoring
Verify a business (KYB)Verify TIN

Monitor TINs for newly formed businesses

Was this page helpful?
Previous

TIN verification review tasks

Next
Built with

TINs for newly formed businesses may take up to two weeks to appear in the IRS database. As a result, initial TIN verification through Middesk may fail, even if the business information is correct.

TINs associated with new businesses are sometimes unverifiable, yielding an unknown status when initially verified through Middesk’s TIN Match. This is due to a data lag in the IRS’s TIN matching program. When a TIN returns an unknown status, it’s typical to request documentation from the business.

Middesk’s TIN Discovery feature provides an alternative approach that seamlessly attempts to re-verify a business’s TIN without further friction imposed on the customer. If a TIN is not found and the business was formed within the last 30 days, Middesk continues verification attempts for up to two weeks after the initial attempt. With TIN Discovery, Middesk attempts to verify the businesses TIN multiple times, at 1, 3, 7 and 14 days after the business is subscribed to monitoring.

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

TIN Discovery lifecycle

Here’s the typical lifecycle of TIN Discovery:

  1. A business gets created with the POST /businesses endpoint.
  1. The business is subscribed to TIN monitoring.
  2. A TIN verification is attempted at 1, 3, 7 and 14 days after subscribed.
  3. Middesk sends a webhook event to registered webhook endpoint(s) if it finds a new TIN status.
  4. The client application ingests and evaluates the change in the business record.

Middesk runs checks on a set cadence for 2 weeks to find TINs for businesses whose TINs were previously unknown.

Enable TIN monitoring

1

Submit a business

Start by submitting a business for verification.

The business must have the TIN property included in the request body in the tin field.
2

Subscribe a business

You can enable monitoring on Middesk businesses using four different strategies.

With an automatic monitoring subscription
With a policy action
With the API
With the Dashboard

Automatically subscribe all businesses when a business verification order completes.

Using webhooks, watch for tin.retried events to receive updates whenever a discovery attempt is made.

Get a demo
Contact your account manager or contact sales to inquire about access.