EIN Lookup

Overview
The EIN Lookup API facilitates the retrieval of detailed company information through searches by EIN (Employer Identification Number) or business name. This service is designed to provide a quick and accurate verification of company identities and their corresponding tax information as registered in the IRS database.
EIN stands for Employer Identification Number. It is a unique nine-digit number assigned by the Internal Revenue Service (IRS) to businesses, non-profits, and other entities for tax identification purposes in the United States.

An EIN is similar to a social security number for individuals. It is used by the IRS to identify businesses and organizations for tax reporting and filing requirements. The EIN is required for various activities, including opening a business bank account, hiring employees, filing tax returns, and conducting certain financial transactions.

The EIN Lookup API provides a robust mechanism for getting information related to companies against company names and other EINs. It is designed to facilitate the confirmation of company identities for financial, legal, and compliance purposes.
Use Cases
Financial Compliance: Utilized by financial institutions to verify company details during account openings or loan processing.
Business Verification: Employed by companies to ensure the authenticity of business partners or vendors before engaging in contracts and agreements.
Regulatory Compliance: Used by compliance officers to validate and ensure that businesses meet regulatory requirements for taxation and business operations.
API Details
Request Body
Pre-Production
Production
Curl
curl --location 'https://api-preproduction.signzy.us/api/v3/us-apis/company/einLookup' \
--header 'Authorization: <---Auth Token--->' \
--header 'Content-Type: application/json' \
--data-raw '{
    "searchMethod": "einNumber/name",
    "searchValue": "201636974",
    "stateCode": "US-FL",
    "zip": "32746",
    "strictSearch": "true"
}'
curl --location 'https://api-preproduction.signzy.us/api/v3/us-apis/company/einLookup' \
--header 'Authorization: <---Auth Token--->' \
--header 'Content-Type: application/json' \
--data-raw '{
    "searchMethod": "einNumber/name",
    "searchValue": "201636974",
    "stateCode": "US-FL",
    "zip": "32746",
    "strictSearch": "true"
}'
﻿
Curl
curl --location 'https://api.signzy.us/api/v3/us-apis/company/einLookup' \
--header 'Authorization: <---Auth Token--->' \
--header 'Content-Type: application/json' \
--data-raw '{
    "searchMethod": "einNumber/name",
    "searchValue": "201636974",
    "stateCode": "US-FL",
    "zip": "32746",
    "strictSearch": "true"
}'
curl --location 'https://api.signzy.us/api/v3/us-apis/company/einLookup' \
--header 'Authorization: <---Auth Token--->' \
--header 'Content-Type: application/json' \
--data-raw '{
    "searchMethod": "einNumber/name",
    "searchValue": "201636974",
    "stateCode": "US-FL",
    "zip": "32746",
    "strictSearch": "true"
}'
﻿
Request Body Mapping
Parameter
Type
Description
Required
searchMethod
String
Method of search, either einNumber or name.
Yes
searchValue
String
The EIN or business name to search.
Yes
stateCode
String
State code where the business is registered.
optional
zip
String
Zip code of the business location.
optional
strictSearch
String
Whether to enforce a strict search matching the exact details.
optional
Response Body
Valid input
{
    "result": {
        "searchMethod": "einNumber",
        "searchValue": "201636974",
        "einSearchOptions": {
            "stateCode": "US-FL",
            "zip": "32746",
            "strictSearch": "true"
        },
        "searchResults": [
            {
                "name": "CAPJR LLC",
                "ein": "201636974",
                "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": [
                    "190 N COUNTRY CLUB RD",
                    "32746",
                    "LAKE MARY",
                    "FL",
                    "US"
                ],
                "formattedAddress": {
                    "street": "190 N COUNTRY CLUB RD",
                    "zip": "32746",
                    "state": "FL",
                    "city": "LAKE MARY",
                    "country": "US"
                }
            }
        ],
        "source": {
            "name": "EIN Finder",
            "info": "",
            "primary": "true"
        }
    }
}

{
    "result": {
        "searchMethod": "einNumber",
        "searchValue": "201636974",
        "einSearchOptions": {
            "stateCode": "US-FL",
            "zip": "32746",
            "strictSearch": "true"
        },
        "searchResults": [
            {
                "name": "CAPJR LLC",
                "ein": "201636974",
                "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": [
                    "190 N COUNTRY CLUB RD",
                    "32746",
                    "LAKE MARY",
                    "FL",
                    "US"
                ],
                "formattedAddress": {
                    "street": "190 N COUNTRY CLUB RD",
                    "zip": "32746",
                    "state": "FL",
                    "city": "LAKE MARY",
                    "country": "US"
                }
            }
        ],
        "source": {
            "name": "EIN Finder",
            "info": "",
            "primary": "true"
        }
    }
}
﻿
API Output Mapping
Field
Type
Description
result
Object
Container for all the API response details.
searchMethod
String
Method used for searching the EIN details.
searchValue
String
EIN or business name used in the search query.
einSearchOptions
Object
Options used in the EIN search query including state code, zip, and strict search settings.
stateCode
String
State code where the business is registered.
zip
String
Zip code of the business location.
strictSearch
Boolean
Whether the search was performed with strict criteria.
searchResults
Array
List of results matching the search criteria. Each item in the array is detailed below.
name
String
Name of the business entity found.
ein
String
Employer Identification Number of the business.
irsScore
String
Score indicating the IRS match quality.
irsScoreExplanation
String
Explanation of the IRS score.
dbaScore
String
Score indicating if the business name is a DBA.
dbaScoreExplanation
String
Explanation of the DBA score.
companyScore
Integer
Numerical score representing the frequency of record appearance under the EIN.
companyScoreExplanation
String
Explanation of the company score.
providedStatus
String
Status provided after verifying the business address.
providedStatusExplanation
String
Explanation of the provided status.
confidenceScore
String
Overall confidence score of the record.
confidenceScoreExplanation
String
Explanation behind the confidence score.
address
Array
Address details as a simple list (not structured).
formattedAddress
Object
Structured address details.
street
String
Street part of the address.
zip
String
Postal zip code part of the address.
state
String
State part of the address.
city
String
City part of the address.
country
String
Country part of the address.
source
Object
Data source information.
name
String
Name of the source (e.g., "EIN Finder").
info
String
Additional information about the source, if any.
primary
Boolean
Indicates if this is the primary source of data.
Sample Error
Wrong stateCode Format 400
companyName not passed 400
Upstream Error 409
Internal Server Error 500
{
    "error": {
        "name": "error",
        "message": "\"stateCode\" must be one of the valid US state codes (US-XX Format)",
        "status": 400,
        "reason": "VALIDATION_ERROR",
        "type": "Bad Request",
        "statusCode": "400"
    }
}
{
    "error": {
        "name": "error",
        "message": "\"stateCode\" must be one of the valid US state codes (US-XX Format)",
        "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 einNumber or name.	Yes
searchValue	String	The EIN or business name to search.	Yes
stateCode	String	State code where the business is registered.	optional
zip	String	Zip code of the business location.	optional
strictSearch	String	Whether to enforce a strict search matching the exact details.	optional

Field	Type	Description
result	Object	Container for all the API response details.
searchMethod	String	Method used for searching the EIN details.
searchValue	String	EIN or business name used in the search query.
einSearchOptions	Object	Options used in the EIN search query including state code, zip, and strict search settings.
stateCode	String	State code where the business is registered.
zip	String	Zip code of the business location.
strictSearch	Boolean	Whether the search was performed with strict criteria.
searchResults	Array	List of results matching the search criteria. Each item in the array is detailed below.
name	String	Name of the business entity found.
ein	String	Employer Identification Number of the business.
irsScore	String	Score indicating the IRS match quality.
irsScoreExplanation	String	Explanation of the IRS score.
dbaScore	String	Score indicating if the business name is a DBA.
dbaScoreExplanation	String	Explanation of the DBA score.
companyScore	Integer	Numerical score representing the frequency of record appearance under the EIN.
companyScoreExplanation	String	Explanation of the company score.
providedStatus	String	Status provided after verifying the business address.
providedStatusExplanation	String	Explanation of the provided status.
confidenceScore	String	Overall confidence score of the record.
confidenceScoreExplanation	String	Explanation behind the confidence score.
address	Array	Address details as a simple list (not structured).
formattedAddress	Object	Structured address details.
street	String	Street part of the address.
zip	String	Postal zip code part of the address.
state	String	State part of the address.
city	String	City part of the address.
country	String	Country part of the address.
source	Object	Data source information.
name	String	Name of the source (e.g., "EIN Finder").
info	String	Additional information about the source, if any.
primary	Boolean	Indicates if this is the 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?

EIN Fetch

Business Verification API - US