TIN Match (Hybrid)

You can perform a TIN check by providing a Business Name or an Individual Name along with their corresponding EIN or SSN. This API call can work both synchronously and asynchronously. The response will include a request ID. The API first attempts to give you the result within the same call, typically within 30 seconds.

If processing a record takes more than 30 seconds due to IRS issues, timeouts, or outages, the record will be queued and processed when the IRS is stable. To check the result, you can either use the GET API call with the request ID or receive a notification at the webhook URL you provided. A message key is returned in the response after a 30-second timeout.

Note: Webhook URLs are stored and activated solely if the endpoint (api/v1/tin/match/tin/match/) encounters a timeout.

{
    "tin": string,
    "name": string,
    “webhook_urls”: [string]
}

{
  "id": interger,
  "name": string,
  "tin": string,
  "status": string,
  "created_by": string,
  "irs_code": integer,
  "irs_reason": string,
  "irs_service_status": string,
  "last_irs_check_date": string,
  "created_date": string,
  "updated_date": string,
  "message": string
   
  }

Request Parameters:

Response Parameters:

What is the IRS code in TIN Match?

IRS provides the results represented as code for each request. Please check the below table to see what each code represents