Skip to main content
Version: 1.7.3

Instant TIN Matching

With TaxBandits Instant TIN Matching service, you can verify the recipient's name and TIN combination against the IRS records in real-time.

  • This service is available only to a limited number of users based on the business use case.
  • If you'd like to use this service, please contact our support team at developer@taxbandits.com with details about your use case, estimated volume, and usage. Learn more

How It Works​

You can use the following endpoints to initiate and track Instant TIN Matching requests.

Note:

To use these endpoints, you must first call the Auth method to obtain an access token. Include this token in your request header as a Bearer token. Refer to OAuth 2.0 Authentication for details on JWT-based authentication.

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

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

On Hold Requests

If the IRS system experiences intermittent issues, the TIN Matching status may show as “ON HOLD”, causing a delay in results.

Once the IRS system is ready, we will complete the TIN Matching and provide the status instantly via Webhook (if configured). The delay can be up to 30 minutes in the Sandbox and up to 36 hours in the Live environment.