Skip to main content
Version: 1.7.3

Overview

With TaxBandits’ TIN Matching service, you can verify the name and TIN combination of multiple recipients against the IRS records in a single API request.

Typically, this process takes up to 24 hours to complete.

How does this work?​

You can use the following endpoints to initiate, track, and manage 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 TIN Matching for the recipients.
  • Cancel – Use this endpoint to cancel a TIN Matching request.
  • List – Use this endpoint to retrieve the list of TIN Matching records.

Status Retrieval​

You can track the status of your TIN Matching requests in two ways:

  • Status – Use this endpoint to retrieve the status of your TIN Matching requests.
  • Webhooks – Configure webhooks for the event type TIN Matching Status Change to receive automated notifications.