US TIN Validation

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
Pre-Production
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"
}'
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"
}'
﻿
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"
}'
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
Valid EIN
Invalid EIN
{
    "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
            }
        ]
    }
}
{
    "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
            }
        ]
    }
}
﻿
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
Wrong Format TIN - 400
Upstream Error 409
Internal Server Error 500
{
    "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"
    }
}
{
    "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"
    }
}
﻿
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
﻿
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 [email protected]. 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!
﻿

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

Field	Type	Description
result	Object	Container for all the response details from the TIN verification request.

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.

Field	Type	Description
tinResult	Object	Contains the results of TIN validation.
einResult	Object	Contains the results of EIN validation.

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.

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.

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).

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.

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

Did this page help you?

US TIN Verification

EIN Fetch