Skip to main content
Version: 1.7.3

Instant TIN Matching

With TaxBandits Instant TIN Matching, you can validate each recipient’s Taxpayer Identification Number (TIN) in real-time and name against IRS records —right at the click of a button.

note

Due to IRS limitations, Instant TIN Matching is available only to limited users.To use this service, contact our support team and provide specific details to provision your account. Learn More

If you try to use this service without provisioning, you’ll receive the following error message:

"You are not authorized to access this content, please contact our support team at developer@taxbandits.com."

How It Works​

You can use the following endpoints to perform and monitor Instant TIN Matching. To access these endpoints, you must first call the Auth method to obtain an access token. This token should be included in the request header as a Bearer token. Refer to OAuth 2.0 Authentication for more details on JWT authentication.

  • Request: Use this endpoint to initiate Instant TIN Matching for a particular recipient.

  • Status: Use this endpoint to get the status of your Instant TIN Matching requests. As an alternative, you can also configure webhooks to retrieve the status.See How.

Note: As the TINs are validated with the IRS database, there may be a few occasions when the IRS has “Intermittent Issues”. During this period, TaxBandits will provide the TIN Matching status as “ON HOLD”. Once the IRS database is ready, we will complete the TIN Matching and provide the status instantly via Webhook (if configured).