--- title: EIN Search API slug: us-apis/ein-search-api docTags: createdAt: 2025-04-01T14:34:11.755Z --- # Overview The EIN Verification API validates and retrieves detailed company information using an Employer Identification Number (EIN) or company name. This API helps businesses ensure regulatory compliance, mitigate risk, and streamline onboarding processes. # Use Cases - **Regulatory Compliance**: Ensure accurate EIN data for legal and tax compliance. - **Business Validation**: Authenticate companies for financial agreements or partnerships. - **Fraud Prevention**: Verify EIN and company name combinations to minimize onboarding risks. # Intended Users - **Financial Institutions**: Compliance checks and fraud prevention during client onboarding. - **Tax Consultants**: EIN validation for tax filing and advisory purposes. - **Business Service Providers**: Verification of company legitimacy for contractual agreements. - **Government Agencies**: Maintain accurate records and compliance validation. ## API Endpoint :::CodeblockTabs Pre Prod ```json curl --location 'https://api-preproduction.signzy.us/api/v3/us-kyb/ein-search' \ --header 'Authorization: ' \ --header 'x-client-unique-id: ' \ --header 'Content-Type: application/json' \ --data-raw '{ "ein": "", "company": "" }' ``` Prod ```json curl --location 'https://api.signzy.us/api/v3/us-kyb/ein-search' \ --header 'Authorization: ' \ --header 'x-client-unique-id: ' \ --header 'Content-Type: application/json' \ --data-raw '{ "ein": "", "company": "" }' ``` ::: ## Request Parameters | Parameter | Type | Required | Description | | ----------- | ------ | -------- | --------------------------------------------------- | | ein | String | No | EIN to validate
It should be a 9 digits Number | | companyName | String | No | Company name to validate | **Note**: At least one parameter (ein or companyName) must be provided. ## Response Format ### Successful Response (status: "Success") :::CodeblockTabs Response ```json { "result": { "status": "Success", "searchLogID": 905686, "data": [ { "companyId": 70615813, "companyName": "KBR HOLDINGS LLC", "city": "HOUSTON", "state": "TX", "zipCode": "770027900", "dateAcquired": "2023-07", "resultViewed": true, "otherPossibleNames": "" }, { "companyId": 54395296, "companyName": "KBR HOLDINGS, LLC", "city": "HOUSTON", "state": "TX", "zipCode": "770027905", "dateAcquired": "2016 or older", "resultViewed": true, "otherPossibleNames": "" } ] } } ``` ::: ### Response Field Explanation | Field | Description | | ------------------ | ---------------------------------------------------------------------------------------------------- | | status | Status of the search request | | searchLogID | Unique ID of the search log entry. | | data | List of company records matched. | | companyId | Unique identifier for the company. | | companyName | Official registered name of the company. | | city | City where the company is registered. | | state | State code (2-letter) of registration. | | zipCode | ZIP code associated with the company. | | dateAcquired | Date when the company information was acquired, or "2016 or older" if it predates the tracked range. | | resultViewed | Boolean indicating if the result was previously viewed. | | otherPossibleNames | Alternative names for the company, if any. | ## Example Requests & Responses ### Example 1: Request using EIN **Request**: :::BlockQuote \{ "ein": "123456789" } ::: **Response**: :::BlockQuote \{ "result": \{ "status": "Success", "searchLogID": 905686, "data": \[ \{ "companyId": 70615813, "companyName": "KBR HOLDINGS LLC", "city": "HOUSTON", "state": "TX", "zipCode": "770027900", "dateAcquired": "2023-07", "resultViewed": true, "otherPossibleNames": "" }, \{ "companyId": 54395296, "companyName": "KBR HOLDINGS, LLC", "city": "HOUSTON", "state": "TX", "zipCode": "770027905", "dateAcquired": "2016 or older", "resultViewed": true, "otherPossibleNames": "" } ] } } ::: ### Example 2: Request using Company Name **Request**: :::BlockQuote \{ "companyName": "KELLOGG BROWN & ROOT LLC" } ::: **Response**: :::BlockQuote \{ "result": \{ "status": "Success", "searchLogID": 972141, "data": \[ \{ "companyId": 19381166, "companyName": "KELLOGG BROWN & ROOT LLC", "city": "ARLINGTON", "state": "VA", "zipCode": "222024811", "dateAcquired": "2016 or older", "resultViewed": false, "otherPossibleNames": "" }, \{ "companyId": 18260610, "companyName": "KELLOGG BROWN & ROOT LLC", "city": "AUSTIN", "state": "TX", "zipCode": "787523738", "dateAcquired": "2016 or older", "resultViewed": false, "otherPossibleNames": "" } ] } } ::: ## Error Handling ### Missing Required Parameter :::CodeblockTabs 404 (data not found using EIN) ```json { "error": { "name": "error", "message": "Data Not Found", "status": "404", "reason": "Not Found", "type": "Not Found", "statusCode": 200 } } ``` 404 (data not found using company name) ```json { "error": { "name": "error", "message": "Data Not Found", "status": "404", "reason": "Not Found", "type": "Not Found", "statusCode": 200 } } ``` 500 (server error) ```json { "error": { "name": "error", "message": "Internal Server Error", "status": 500, "reason": "ERROR", "type": "Conflict", "statusCode": 500 } } ``` 409 (upstream issue) ```json { "error": { "name": "error", "message": "Error in getting data from Upstream", "status": 409, "reason": "ERROR", "type": "Conflict", "statusCode": 409 } } ``` 400 (Bad Request) ```json { "error": { "name": "error", "message": "Bad Request. EIN 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": "Only one Field is Required, Either Search by 'tin' or 'company'", "status": "400", "reason": "BAD_REQUEST", "type": "Bad Request", "statusCode": "400" } } ---- { "error": { "name": "error", "message": "Bad Input and description. Please check the input.", "status": "400", "reason": "BAD_REQUEST", "type": "Bad Request", "statusCode": "400" } } ``` ::: :::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! :::