--- title: EIN Lookup slug: us-apis/ein-lookup description: Learn about the Employer Identification Number (EIN) and the EIN Lookup API in this informative document. Discover how this API can be used in tax compliance, financial transactions, supplier verification, and more. Explore the required parameters and fin docTags: createdAt: 2023-09-01T07:08:49.935Z --- # 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 ::::Tabs :::Tab{title="Pre-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" }' ``` ::: :::Tab{title="Production"} ```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" }' ``` ::: :::: ### 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 :::CodeblockTabs 200 - success ```json { "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" } } } ``` ```json { "result": { "searchMethod": "einNumber", "searchValue": "821104267", "einSearchOptions": { "stateCode": "US-AZ", "zip": "85086", "strictSearch": "true" }, "searchResults": [], "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 :::CodeblockTabs Wrong stateCode Format 400 ```json { "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" } } ``` companyName not passed 400 ```json { "error": { "name": "error", "message": "Bad Request. \"searchValue\" can include only 9 digits when \"searchMethod\" is 'einNumber'.", "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! :::