TIN Verification

Overview
A Taxpayer Identification Number (TIN) is a unique identification number used by the Internal Revenue Service (IRS) in the administration of tax laws. While there are various types of TINs, all businesses will have some form of TIN, which will act as a unique identifier of a business entity.
The list of TIN types are the following:
Social Security Number (SSN)
Employer Identification Number (EIN)
Individual Taxpayer Identification Number (ITIN)
Taxpayer Identification Number for Pending U.S. Adoptions (ATIN)
Preparer Taxpayer Identification Number (PTIN)
All valid business entities will have an EIN issued by the IRS. The Federal government requires a legal entity to have an EIN to pay employees and to file business tax returns. To be considered a Partnership, LLC, Corporation, S Corporation, Non-profit, etc., a business must obtain an EIN when incorporating. EINs do not expire. Once an EIN has been issued to an entity, it will not be reissued. As such, each EIN is unique to a business and persists over time.
How Does Signzy Help in Verifying TIN?
Verifying the TIN of a business is a crucial part of business verification. Signzy will verify if a TIN is valid or not and that it matches the name passed to Signzy. If the TIN is unable to be verified or does not match the name provided, Signzy will perform a series of lookups to identify alternate names that may be associated with that TIN.
Use Cases:
Tax Filing and Reporting
: TINs are required on all tax documents. They are used to track an individual's or business's tax obligations and ensure proper tax compliance.
Opening a Bank Account
: Banks and financial institutions often require a TIN to open a bank account, particularly for business accounts.
Employment
: Employers use an individual’s SSN to report earnings to the IRS and state taxing authorities.
Credit Applications
: TINs are used when applying for credit. Credit bureaus use it to identify an individual’s credit records accurately.
Government Benefits
: SSNs are required to apply for government services and benefits, such as unemployment benefits or social security benefits.
API Details
API 1: TIN Verification Request
Sample cURL
Pre-production
Production
curl --location 'https://api-preproduction.signzy.us/api/v3/us-kyb/tin-verify' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: <----kong auth token---->' \
--data '{
    "name": "Yahoo Inc",
    "tin": "770434749",
    "callbackUrl": "<-------url------->"
}'
curl --location 'https://api-preproduction.signzy.us/api/v3/us-kyb/tin-verify' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: <----kong auth token---->' \
--data '{
    "name": "Yahoo Inc",
    "tin": "770434749",
    "callbackUrl": "<-------url------->"
}'
﻿
API Input Mapping:
Field
Type
Description
name
string
The name of the business to verify.
tin
string
The Taxpayer Identification Number.
callbackUrl
string
URL to receive the callback with results.
Sample Response
Curl
{
    "result": {
        "businessId": "36d42f48-24a3-4243-9c8c-6f06c492bbf1",
        "status": "PROCESSING",
        "statusCode": 102
    }
}
{
    "result": {
        "businessId": "36d42f48-24a3-4243-9c8c-6f06c492bbf1",
        "status": "PROCESSING",
        "statusCode": 102
    }
}
﻿
API Output Mapping:
Field
Type
Description
businessId
string
Unique identifier for the business request.
status
string
Current status of the request (PROCESSING).
statusCode
int
Numeric code representing the processing status (102).
API 2: Fetch TIN Verification Result
Sample cURL
Pre-production
Production
curl --location 'https://api.signzy.us/api/v3/us-kyb/tin-verify-fetch' \
--header 'Authorization: <----kong auth token---->' \
--header 'Content-Type: application/json' \
--data '{
    "businessId": "36d42f48-24a3-4243-9c8c-6f06c492bbf1"
}'
curl --location 'https://api.signzy.us/api/v3/us-kyb/tin-verify-fetch' \
--header 'Authorization: <----kong auth token---->' \
--header 'Content-Type: application/json' \
--data '{
    "businessId": "36d42f48-24a3-4243-9c8c-6f06c492bbf1"
}'
﻿
API 2 Input Mapping
Field
Type
Description
businessId
string
Unique identifier for the business verification request.
Sample Response
Response Body
{
    "result": {
        "businessId": "36d42f48-24a3-4243-9c8c-6f06c492bbf1",
        "name": "Yahoo Inc",
        "tin": "77-0434749",
        "status": "failure",
        "label": "TIN Match",
        "subLabel": "Mismatch",
        "message": "We believe the submitted TIN is associated with a different Business Name",
        "verified": false,
        "mismatch": true,
        "unknown": false,
        "issued": true,
        "error": ""
    }
}
{
    "result": {
        "businessId": "36d42f48-24a3-4243-9c8c-6f06c492bbf1",
        "name": "Yahoo Inc",
        "tin": "77-0434749",
        "status": "failure",
        "label": "TIN Match",
        "subLabel": "Mismatch",
        "message": "We believe the submitted TIN is associated with a different Business Name",
        "verified": false,
        "mismatch": true,
        "unknown": false,
        "issued": true,
        "error": ""
    }
}
﻿
API Output Mapping
Field
Type
Description
businessId
string
business identifier that helps in retrieving the response
name
string
The business name associated with the TIN.
tin
string
TIN number 
status
string
Status of the verification (failure, success).
label
string
General label of the result 
subLabel
string
Specific result descriptor 
message
string
Detailed message about the verification result.
verified
boolean
Indicates if the TIN is verified.
mismatch
boolean
True if there is a mismatch in the TIN and name.
unknown
boolean
True if the TIN or business name is unknown.
issued
boolean
Indicates if the TIN has been officially issued.
error
string
Error message, if any.
Error Code Response & Mapping
400(Bad Request)
401(Unauthorized)
403(Forbidden
500(Internal Server Error)
409(Upstream Down Error)
{
  "error": {
     "name": "error",
     "message": "Internal server error",
     "status": 500,
     "reason": "ERROR",
     "type": "Bad Request",
     "statusCode": "500"
  }
}
{
  "error": {
     "name": "error",
     "message": "Internal server error",
     "status": 500,
     "reason": "ERROR",
     "type": "Bad Request",
     "statusCode": "500"
  }
}
﻿
Field
Type
Description
name
string
Text displayed on the screen explaining error type.
reason
string
Reason for the error.
status
number
HTTP status code.
message
string
Error message indicating an upstream error.
type
string
Error type.
statusCode
string
Status code representing the error scenario.
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!
﻿

Field	Type	Description
name	string	The name of the business to verify.
tin	string	The Taxpayer Identification Number.
callbackUrl	string	URL to receive the callback with results.

Field	Type	Description
businessId	string	Unique identifier for the business request.
status	string	Current status of the request (PROCESSING).
statusCode	int	Numeric code representing the processing status (102).

Field	Type	Description
businessId	string	Unique identifier for the business verification request.

Field	Type	Description
businessId	string	business identifier that helps in retrieving the response
name	string	The business name associated with the TIN.
tin	string	TIN number
status	string	Status of the verification (failure, success).
label	string	General label of the result
subLabel	string	Specific result descriptor
message	string	Detailed message about the verification result.
verified	boolean	Indicates if the TIN is verified.
mismatch	boolean	True if there is a mismatch in the TIN and name.
unknown	boolean	True if the TIN or business name is unknown.
issued	boolean	Indicates if the TIN has been officially issued.
error	string	Error message, if any.

Field	Type	Description
name	string	Text displayed on the screen explaining error type.
reason	string	Reason for the error.
status	number	HTTP status code.
message	string	Error message indicating an upstream error.
type	string	Error type.
statusCode	string	Status code representing the error scenario.

Did this page help you?

Canada KYB Verification

EIN Verification(Basic Check)