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"
}
| Attribute | Type | Description |
|---|---|---|
| name | string | The 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 | string | TIN that was provided during Business creation |
| verified | boolean | Details 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) | string | 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 “person”. This is an optional feature, please contact sales if you would like access to this field. |
| mismatch | boolean | If the TIN is not verified against the submitted name, Middesk may return a recommended entity name which will be flagged as a mismatch. |
| unknown | boolean | If the TIN is not verified against the submitted name and no potential name is found, the TIN will be flagged as unknown. |
| error | string | If 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_id | string | The id of the Business this TIN belongs to |
| created_at | timestamp | The timestamp when this TIN was created |
| updated_at | timestamp | The 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."
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”
}