Employer Identification Numbers (EIN) are a unique Federal ID assigned to each registered business entity. An EIN should be matched against a legal entity name as a baseline business verification process.

{
  "object": "tin",
  "name": "Middesk, Inc.",
  "tin": "27-1883160",
  "verified": false,
  "verified_by": "business",
  "mismatch": false,
  "unknown": true,
  "error": null,
  "business_id": "32e7fb2c-60ca-4ddc-add2-694475b73f2b",
  "created_at": "2019-01-21T06:43:23.313Z",
  "updated_at": "2019-01-21T06:44:07.184Z"
}
AttributeTypeDescription
name stringThe legal entity name that is associated with that TIN. The name field is null by default when the business and tin object are created, but filled once we have fulfilled the report.
tin stringTIN that was provided during Business creation
verifiedbooleanDetails on whether the TIN that was provided belongs to the entity name that was provided. The verified field is null by default when the business and tin object are created, but filled once we have fulfilled the report.
verified_by
(optional)
stringIf the TIN is verified using the business name, this field will be populated with “business”. If the TIN is verified using the person’s name, this field will be populated with “person”. This is an optional feature, please contact sales if you would like access to this field.
mismatch booleanIf the TIN is not verified against the submitted name, Middesk may return a recommended entity name which will be flagged as a mismatch.
unknown booleanIf the TIN is not verified against the submitted name and no potential name is found, the TIN will be flagged as unknown.
errorstringIf there is an error on the TIN Matching request such as the IRS being unavailable, this field will be populated with the error string (e.g. irs_unavailable)
business_idstringThe id of the Business this TIN belongs to
created_attimestampThe timestamp when this TIN was created
updated_attimestampThe timestamp when this TIN was last updated

Verification of EINs/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 utilize this feature, we will want to ensure that you are passing in both the EIN/TIN and the individual's name. Note that this is an optional feature that can be turned on by reaching out to your Account Manager or to [email protected]

Dashboard:
If the TIN is verified using a person's name, a warning will be displayed on the TIN match card as a “Person Match."

622

EIN Verification JSON Response:
The Employer Identification Numbers (EIN) response now includes verified_by as an optional field. If the TIN is verified using the business name, this field will be populated with business. If the TIN is verified using the person’s name, this field will be populated with the "person."

{
  "object": "tin",
  "name": "Middesk, Inc.",
  "tin": "27-5683160",
  "verified": true,
  "verified_by": "business",
  "mismatch": false,
  "unknown": false,
  "error": null,
  "business_id": "32e7fb2c-60ca-4ddc-add2-694475b73f2b",
  "created_at": "2019-01-21T06:43:23.313Z",
  "updated_at": "2019-01-21T06:44:07.184Z"
}
{
  "object": "tin",
  "name": "Middesk, Inc.",
  "tin": "27-5683160",
  "verified": false,
  "verified_by": "business",
  "mismatch": false,
  "unknown": true,
  "error": null,
  "business_id": "32e7fb2c-60ca-4ddc-add2-694475b73f2b",
  "created_at": "2019-01-21T06:43:23.313Z",
  "updated_at": "2019-01-21T06:44:07.184Z"
}
{
  "object": "tin",
  "name": "Middesk, Inc.",
  "tin": "27-5683160",
  "verified": false,
  "verified_by": "business",
  "mismatch": false,
  "unknown": false,
  "error": 'invalid_tin',
  "business_id": "32e7fb2c-60ca-4ddc-add2-694475b73f2b",
  "created_at": "2019-01-21T06:43:23.313Z",
  "updated_at": "2019-01-21T06:44:07.184Z"
}

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

{
  “key”: “unique identifier for the task”
  “category”: “tin”,
  “label”: “TIN Match”,
  “sub_label”: “Warning”,
  “status”: “warning”,
  “message”: “The IRS has a record for the submitted TIN and Person Name combination”
}