- Docs
- API reference
- Endpoints and schemas
- GraphQL
- Selection
Tin
Taxpayer Identification Number (TIN).
Selection. This type is a selection. You reach it through a connection, and you choose which of its fields come back.
A Taxpayer Identification Number (TIN) is an identification number assigned by the IRS for tax administration. TIN data is available on Legal Entities and is commonly used in business verification and KYB workflows to confirm that a business is who they claim to be.
Both EINs (Employer Identification Numbers) and SSNs (Social Security Numbers) are types of TIN.
All businesses that have a non-person legal structure have an EIN. Many sole proprietorships also acquire an EIN, but some may use the owner’s SSN as well.
See the tinType field below for the full list of TIN types. Note that we do not provide SSN to protect PII.
Data Sources
Section titled “Data Sources”Our TIN data comes directly from authoritative government sources like SoS registrations and IRS forms.
Currently, TIN coverage is approximately 4.5% of brands. Florida-registered businesses are overrepresented as Florida is the only state that publishes federal EIN data on its Secretary of State registrations.
Methodology
Section titled “Methodology”We routinely validate our data against the IRS directly to ensure data quality is maintained. Our entity resolution process further reconciles records across sources to surface the most accurate TIN for each legal entity. For absolute confidence in a specific business and EIN combination, you can submit another request with the TIN, legal name, and address as inputs to verify directly against the IRS in realtime. Below is an example:
query TinExample \{ search( searchInput: \{ name: "LOFTY COFFEE INC.", tin: \{ tin: "464362767"\}, address: \{ state: "CA" \} \} ) \{ ... on LegalEntity \{ names \{ edges \{ node \{ name \} \} \} tins \{ edges \{ node \{ tin tinType validity \} verificationResult verificationStatus \} \} \} \}\}\{ "data": \{ "search": [ \{\}, \{ "names": \{ "edges": [ \{ "node": \{ "name": "LOFTY COFFEE INC." \} \} ] \}, "tins": \{ "edges": [ \{ "node": \{ "tin": "464362767", "tinType": "EIN", "validity": "valid" \}, "verificationResult": "tin_verified", "verificationStatus": "Success" \} ] \} \} ] \}\}Where it appears
Section titled “Where it appears”Shortest path from a primary entity: Brand → legalEntities → LegalEntity → tins → Tin.
LegalEntity.tinsRecord.tins
Fields
Section titled “Fields”| Field | Label | Type | Description |
|---|---|---|---|
id |
ID | UUID! |
The unique identifier of this object. |
tin |
TIN | String |
The taxpayer identification number. |
tinType |
TIN Type | String |
The type of TIN on record, such as EIN or SSN. See the values. |
validity |
Validity | String |
Verification status for a business and TIN combination when checked against live IRS records. See the values. |
firstObservedDate |
First Observed Date | String |
The earliest date of a source record that supports this attribute or relationship. The source date is, for example, the date when Enigma collected the record or when the source last updated it. Most values have a date, a time, and a UTC offset, but some have the date only. |
lastObservedDate |
Last Observed Date | String |
The latest date of a source record that supports this attribute or relationship. It uses the same source dates and the same format as firstObservedDate. |
rank |
Rank | Int |
Determines the display order of the attribute, with lower values shown first |
internalId |
String |
A numeric identifier that Enigma assigns to this object when it builds its data. On most attribute objects, id is the UUID form of this number. |
|
internalTinId |
String |
A numeric identifier that Enigma assigns to the taxpayer identification number (TIN) when it builds its data. All Tin objects for one TIN share this value. |
tinType values
Section titled “tinType values”In practice, we only provide EIN data currently.
| Value | Meaning |
|---|---|
EIN |
Employer Identification Number, the primary identifier for businesses such as corporations, partnerships, LLCs, and nonprofits. |
SSN |
Social Security Number, assigned to individuals. This may appear for sole proprietorships. |
ITIN |
Individual Taxpayer Identification Number, issued to individuals who need a U.S. taxpayer ID but are not eligible for an SSN. |
ATIN |
Adoption Taxpayer Identification Number. |
PTIN |
Preparer Tax Identification Number, issued to paid tax return preparers. |
validity values
Section titled “validity values”We populate validity only when a request is made to verify a specific business and TIN combination against live IRS records. To do so, include the business name and TIN you are verifying in the request and ask for verificationResult and verificationStatus in the output.
| Value | Meaning |
|---|---|
issued |
The TIN is valid and issued by the IRS. |
not_issued |
The TIN has not been issued by the IRS. |
invalid |
The TIN is invalid. |
null |
The validity has not been confirmed. |
Connections
Section titled “Connections”Each one is a connection: read it through edges { node { … } }, page it with first, and narrow it with conditions.
| Field | Leads to | Description |
|---|---|---|
legalEntities |
LegalEntity |
Legal entities that file taxes with this TIN. Default first: 100. |
records |
Record |
A structured entry from an upstream data source, such as a government filing or business registration, from which Enigma derives and links business entities. Default first: 10. |
Math fields
Section titled “Math fields”Every record of this type answers count, countDistinct, has, sum, min, max, avg, collect, minDateTime, maxDateTime. Each takes field and an optional conditions. See Selection.
Example
Section titled “Example”query { search(searchInput: { entityType: BRAND name: "Safeway" conditions: { limit: 1 } }) { ... on Brand { id legalEntities(first: 1) { edges { node { tins(first: 1) { edges { node { id tin tinType validity firstObservedDate } } } } } } } }}Response, as returned:
{ "data": { "search": [ { "id": "0f26fbef-3436-4f85-8bcd-31fe12a4f99a", "legalEntities": { "edges": [ { "node": { "tins": { "edges": [ { "node": { "id": "00000050-0000-249a-0000-0a8000000000", "tin": "264563006", "tinType": "EIN", "validity": null, "firstObservedDate": "2026-09-03 23:08:56+00" } } ] } } } ] } } ] }}