Instant TIN Matching
With TaxBandits' Instant TIN Matching service, you can verify a recipient's name and TIN combination against IRS records in real time.
How to enable
Before using this endpoint, you must enable Instant TIN Matching for your account.
-
Sandbox: Enable Instant TIN Matching in the Developer Console to start testing. Learn more
-
Live: Contact our support team at developer@taxbandits.com with your use case, estimated volume, and expected usage to request access. Available only to a limited number of users, based on business use case.
How it works
You can use the following endpoints to initiate and track Instant TIN Matching requests.
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
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.