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,
  "mismatch": false,
  "unknown": true,
  "error": null,
}

Attribute

Type

Description

name

string

The legal entity name that is associated with that TIN

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.

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)