TIN object

This page describes what Middesk returns when you run a Taxpayer Identification Number (TIN) match request.

1
{
2
  "object": "tin",
3
  "name": "Middesk, Inc.",
4
  "tin": "27-1883160",
5
  "verified": false,
6
  "verified_by": "business",
7
  "mismatch": false,
8
  "unknown": true,
9
  "issued": true,
10
  "error": null,
11
  "business_id": "32e7fb2c-60ca-4ddc-add2-694475b73f2b",
12
  "created_at": "2019-01-21T06:43:23.313Z",
13
  "updated_at": "2019-01-21T06:44:07.184Z"
14
}

TIN attributes

TIN review tasks

To make decisioning easier off the above TIN data, key insights aggregate into review tasks on the Business payload (business.review.review_tasks).

TIN Match

This review task indicates if Middesk could verify the TIN and name match with the IRS. The following example indicates the possible states of this task. The TIN is only verified against the person name if that feature is enabled for your account.

1
{
2
  "key": "tin",
3
  "category": "tin",
4
  "label": "TIN Match",
5
  "sub_label": "Found",
6
  "sub_key": "found",
7
  "status": "success",
8
  "message": "The IRS has a record for the submitted TIN and Business Name combination"
9
}

TIN Error

When TIN Match results in an error, an additional TIN Error review task is available to allow for more granular actions depending on the type of error.

1
{
2
  "key": "tin_error",
3
  "category": "tin",
4
  "label": "TIN Error",
5
  "sub_label": "IRS Unavailable",
6
  "sub_key": "irs_unavailable",
7
  "status": "failure",
8
  "message": "IRS Unavailable"
9
}

TIN Issued

If the TIN fails to be verified against the Business name provided, the IRS indicates if the TIN has been issued or not. Newly issued TINs may take several days to several weeks to be processed into the IRS’ database, so if this status is received from the IRS, it could be the case that the TIN is still being processed at the IRS. This review task is present if the IRS indicates that the TIN is not yet issued, otherwise, it won’t be present in the review tasks list.

1
{
2
  "key": "tin_issued",
3
  "category": "tin",
4
  "label": "TIN Match",
5
  "sub_label": "Not Issued",
6
  "sub_key": "not_issued",
7
  "status": "failure",
8
  "message": "TIN has not been issued by the IRS. There is often a delay after formation for the IRS database to process TINs for new businesses."
9
}

Verify EINs and SSNs against individuals

Some small businesses like single-member LLCs have EINs that match an officer’s name instead of the registered business name. To use this feature, you must pass in both the EIN/TIN and the individual’s name.

If the TIN is verified using a person’s name, a warning displays on the TIN match card in the Middesk Dashboard as a Person Match.

EIN verification JSON response

The Employer Identification Numbers (EIN) response includes verified_by as an optional field. If the TIN is verified using the business name, this field populates with business. If the TIN is verified using the person’s name, this field populates with the “person.”

1
{
2
  "object": "tin",
3
  "name": "Middesk, Inc.",
4
  "tin": "27-5683160",
5
  "verified": true,
6
  "verified_by": "business",
7
  "mismatch": false,
8
  "unknown": false,
9
  "issued": null,
10
  "error": null,
11
  "business_id": "32e7fb2c-60ca-4ddc-add2-694475b73f2b",
12
  "created_at": "2019-01-21T06:43:23.313Z",
13
  "updated_at": "2019-01-21T06:44:07.184Z"
14
}

Example review task JSON response

If the EIN/TIN is verified using the person’s name, the Review Task API (business.review.review_tasks) returns a response with a warning sublabel and the following message: “The IRS has a record for the submitted TIN and Person Name combination.”

1
{
2
  "key": "unique identifier for the task",
3
  "category": "tin",
4
  "label": "TIN Match",
5
  "sub_label": "Warning",
6
  "status": "warning",
7
  "message": "The IRS has a record for the submitted TIN and Person Name combination"
8
}