--- title: US TIN Validation slug: us-apis/us-tin-validation description: Learn about the importance of an Employer Identification Numbers (EIN) for businesses and organizations in the US. Discover the EIN Verification API, a tool that validates the accuracy of EINs against official records. Explore practical examples of its ap docTags: createdAt: 2023-09-01T07:10:06.587Z --- ### Introduction The US TIN Validation API enables users to verify Tax Identification Numbers (TIN) and Employer Identification Numbers (EIN) against existing records. This API is can help businesses and financial institutions to ensure the authenticity of tax-related information provided by companies. ### Use Cases - **Tax Compliance**: Facilitates tax compliance by allowing businesses to validate TINs and EINs against IRS records, ensuring all tax-related documents are accurate. - **Fraud Prevention**: Assists in detecting and preventing tax fraud by verifying the accuracy of TIN and EIN details submitted by businesses. - **Business Verification**: Enables verification of business legitimacy through TIN/EIN matching, crucial for due diligence and risk assessment. ## API Details ### Request Body ::::Tabs :::Tab{title="Pre-Production"} ```curl curl --location 'https://api-preproduction.signzy.us/api/v3/company/tin-verification' \ --header 'Authorization: <----Auth Token---->' \ --header 'Content-Type: application/json' \ --data-raw '{ "searchMethod": "advance", "searchValue": "200754820", "name": "Tesla" }' ``` ::: :::Tab{title="Production"} ```curl curl --location 'https://api.signzy.us/api/v3/company/tin-verification' \ --header 'Authorization: <----Auth Token---->' \ --header 'Content-Type: application/json' \ --data-raw '{ "searchMethod": "advance", "searchValue": "200754820", "name": "Tesla" }' ``` ::: :::: ### Request Body Parameters | **Parameter** | **Type** | **Description** | **Required** | | ------------- | -------- | ------------------------------------------------------ | ------------ | | searchMethod | String | Method of search, either **'advance'** or **'basic'**. | Yes | | searchValue | String | The TIN or EIN number. Should be 9 digits long | Yes | | name | String | The name of the company associated with the TIN/EIN. | Yes | :::CodeblockTabs Valid EIN ```json { "result": { "searchMethod": "advance", "searchValue": "200754820", "name": "Tesla", "isValidTin": true, "isValidEin": true, "searchResult": { "tinResult": { "validationStatus": "IRS Match found. TIN and Name combination matches IRS EIN records", "matchStatus": "EIN Possible Match found.", "possibleMatch": "TESLA OFFSHORE LLC" }, "einResult": { "name": "TESLA OFFSHORE LLC", "ein": "200754820", "irsScore": "A", "irsScoreExplanation": "100% match between name and EIN in the IRS database.", "dbaScore": "NO", "dbaScoreExplanation": "Company name is a legal name for the business and not DBA", "companyScore": 100, "companyScoreExplanation": "This record appears 100% of times under the associated EIN", "providedStatus": "A", "providedStatusExplanation": "Address has been verified and is NCOA Plus 4", "confidenceScore": "A", "confidenceScoreExplanation": "This record appears 100% of times under the associated EIN", "address": [ "12514 CUTTEN RD ", "77066", "HOUSTON", "TX", "US" ], "formattedAddress": { "street": "12514 CUTTEN RD", "zip": "77066", "state": "TX", "city": "HOUSTON", "country": "US" } } }, "sources": [ { "name": "Internal Revenue Service (IRS) Tin Matching Service", "info": "", "primary": true }, { "name": "TIN Check", "info": "", "primary": true }, { "name": "EIN Finder", "info": "", "primary": true } ] } } ``` Invalid EIN ```json { "result": { "ein": "320174439", "validationStatus": false, "irsScore": null, "irsScoreExplanation": null, "dbaScore": null, "dbaScoreExplanation": null, "confidenceScore": null, "confidenceScoreExplanation": null, "timestamp": 1695970498 } } ``` ::: ### Response Body Parameters **Top-Level Result Object** | **Field** | **Type** | **Description** | | --------- | -------- | ------------------------------------------------------------------------- | | result | Object | Container for all the response details from the TIN verification request. | **Result Details** | **Field** | **Type** | **Description** | | ------------ | -------- | ------------------------------------------------------------------ | | searchMethod | String | Specifies whether the 'advance' or 'basic' search method was used. | | searchValue | String | The TIN/EIN number that was validated. | | name | String | The company name associated with the TIN/EIN. | | isValidTin | Boolean | True if the TIN provided is valid, otherwise false. | | isValidEin | Boolean | True if the EIN provided is valid, otherwise false. | | searchResult | Object | Detailed container holding results for TIN and EIN verification. | **SearchResult Object Details** | **Field** | **Type** | **Description** | | --------- | -------- | --------------------------------------- | | tinResult | Object | Contains the results of TIN validation. | | einResult | Object | Contains the results of EIN validation. | **TinResult Sub-Object** | **Field** | **Type** | **Description** | | ---------------- | -------- | -------------------------------------------------------------------------------------------------------- | | validationStatus | String | Describes the IRS match status, e.g., "IRS Match found." | | matchStatus | String | Provides more detailed match status, e.g., "EIN Possible Match found." | | possibleMatch | String | Names the entity that possibly matches the given TIN, enhancing user clarity on potential discrepancies. | **EinResult Sub-Object** | **Field** | **Type** | **Description** | | -------------------------- | -------- | ------------------------------------------------------------------------------ | | name | String | Legal name of the company as registered with the IRS. | | ein | String | The validated Employer Identification Number. | | irsScore | String | A grade or score (e.g., 'A') representing the match quality with IRS records. | | irsScoreExplanation | String | Explanation of the IRS score, detailing the level of match accuracy. | | dbaScore | String | Indicates whether the company operates under a DBA (Doing Business As). | | dbaScoreExplanation | String | Explanation of the DBA score, indicating if the name is a legal or trade name. | | companyScore | Integer | Numerical score indicating the frequency of records under the associated EIN. | | companyScoreExplanation | String | Explains the basis for the company score provided. | | providedStatus | String | Status based on address verification (e.g., 'A' for verified). | | providedStatusExplanation | String | Details the reasons behind the provided status. | | confidenceScore | String | Score indicating the overall confidence in the record's validity. | | confidenceScoreExplanation | String | Explanation for the confidence score given. | | address | Array | Array of strings representing different parts of the company's address. | | formattedAddress | Object | Object containing structured address information. | **FormattedAddress Object** | **Field** | **Type** | **Description** | | --------- | -------- | ---------------------------------------------------- | | street | String | Street address of the company. | | zip | String | Postal code where the company is located. | | state | String | State abbreviation where the company is registered. | | city | String | City where the company is located. | | country | String | Country abbreviation (e.g., 'US' for United States). | **Sources Array** | **Field** | **Type** | **Description** | | --------- | -------- | ------------------------------------------------------------------------------------- | | sources | Array | List of sources used for the verification process. | | name | String | Name of the data source, e.g., "Internal Revenue Service (IRS) Tin Matching Service". | | info | String | Additional information about the source, if any. | | primary | Boolean | Indicates whether the source is a primary source of data. | ### Error Code and Mapping ### Sample Error :::CodeblockTabs Wrong Format TIN - 400 ```json { "error": { "name": "error", "message": "Bad Request. searchValue is not correct. Please make sure it is a 9 digit numeric value. No alphabets or special characters allowed.", "status": 400, "reason": "VALIDATION_ERROR", "type": "Bad Request", "statusCode": "400" } } ``` Upstream Error 409 ```json { "error": { "name": "error", "message": "Error in getting data from Upstream", "status": 409, "reason": "ERROR", "type": "Conflict", "statusCode": 409 } } ``` Internal Server Error 500 ```json { "error": { "name": "error", "message": "Internal Server Error", "status": 500, "reason": "ERROR", "type": "Conflict", "statusCode": 500 } } ``` ::: ### Error Response Parameters | **Parameter** | **Description** | | ---------------- | --------------------------------- | | error | This parameter contains the error | | error.name | The error name. | | error.message | The error message. | | error.status | Status of the api | | error.reason | Reason for error | | error.type | Type of the error | | error.statusCode | Request Status code from Signzy | :::hint{type="info"} ### Getting help Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better. You can reach out to us at [help@signzy.com](#). We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively. We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you! :::