--- title: EIN Business Details API slug: us-apis/ein-business-details-api docTags: createdAt: 2025-04-01T15:16:31.507Z --- ## Overview The EIN Business Details API retrieves comprehensive details about a specific company using the unique identifiers (searchLogID and companyId) provided from the initial EIN search API. This API supports seamless integration into compliance, onboarding, and validation workflows, delivering precise business insights for regulatory and operational use cases. ## Use Cases - **Regulatory Compliance**: Obtain detailed EIN data to satisfy legal and tax reporting obligations. - **Business Validation**: Verify detailed company profiles for partnerships and contractual engagements. - **Fraud Prevention**: Authenticate business details to ensure legitimacy during onboarding processes. ## Intended Users - **Financial Institutions**: Compliance and fraud risk assessments. - **Tax Consultants**: Comprehensive EIN verification for accurate filings. - **Business Service Providers**: In-depth company authentication for service delivery or contract initiation. - **Government Agencies**: Detailed recordkeeping and compliance validation. ## API Endpoint :::CodeblockTabs Pre Prod ```json curl --location 'https://api-preproduction.signzy.us/api/v3/us-api/us-kyb/ein-business-details' \ --header 'Authorization: ' \ --header 'x-client-unique-id: ' \ --header 'Content-Type: application/json' \ --data-raw '{ "searchId": "905686", "companyId": "70615813" }' ``` Prod ```json curl --location 'https://api.signzy.us/api/v3/us-api/us-kyb/ein-business-details' \ --header 'Authorization: ' \ --header 'x-client-unique-id: ' \ --header 'Content-Type: application/json' \ --data-raw '{ "searchId": "905686", "companyId": "70615813" }' ``` ::: ## Request Parameters | Parameter | Type | Required | Description | Example | | --------- | ------- | -------- | -------------------------------------------------------------------------------------------------------------------- | -------- | | searchLId | Integer | Yes | Search ID of the company obtained from the initial [EIN Search API](docId\:RTqkcWx9_T9eh8_TmZsim) - Step 1 result. | 905686 | | companyId | Integer | Yes | Company ID of the company obtained from the initial [EIN Search API](docId\:RTqkcWx9_T9eh8_TmZsim) - Step 1 result. | 70615813 | ## Response Format ### Successful Response :::CodeblockTabs Response ```json { "result": { "status": "Success", "data": { "companyId": "70615813", "ein": "320158407", "companyName": "KBR HOLDINGS LLC", "address": "601 JEFFERSON ST STE STREETKT", "address2": "", "city": "HOUSTON", "state": "TX", "zipCode": "770027900", "telephone": "", "fax": "", "website": "", "firstName": "", "middleName": "", "lastName": "", "email": "", "sic": "", "totalEmployees": "", "salesRevenue": "", "headQuarter": "", "ncoa": "", "dateAcquired": "2023-07", "ncoaUpdateDate": "2024-06", "otherPossibleNames": "", "ncoaStatus": "V", "ncoaMatchFlag": "" } } } ``` ::: ### Response Field Explanation | Field | Description | | ------------------ | -------------------------------------------- | | companyId | Unique identifier for the company. | | ein | Employer Identification Number (EIN). | | companyName | Official company name. | | address | Primary business address. | | address2 | Secondary address information (optional). | | city | City of business location. | | state | State code (2-letter) of business location. | | zipCode | ZIP code of business location. | | telephone | Company’s contact phone number (optional). | | fax | Company’s fax number (optional). | | website | Company's website URL (optional). | | firstName | First name of contact person (optional). | | middleName | Middle name of contact person (optional). | | lastName | Last name of contact person (optional). | | email | Email address of contact person (optional). | | sic | Standard Industrial Classification code. | | totalEmployees | Number of company employees (optional). | | salesRevenue | Company’s annual revenue (optional). | | headQuarter | Indicates if this location is headquarters. | | ncoa | National Change of Address information. | | dateAcquired | Date the data was confirmed or last updated. | | ncoaUpdateDate | Date of the latest NCOA verification. | | otherPossibleNames | Alternative registered names (optional). | | ncoaStatus | Status of NCOA verification ("V" = Valid). | | ncoaMatchFlag | Additional NCOA matching status details. | ## Example Request & Response ### Request Example :::BlockQuote \{ "searchLogID": 905686, "companyId": 70615813 } ::: ### Response Example :::BlockQuote \{ "result": \{ "status": "Success", "data": \{ "companyId": "70615813", "ein": "320158407", "companyName": "KBR HOLDINGS LLC", "address": "601 JEFFERSON ST STE STREETKT", "address2": "", "city": "HOUSTON", "state": "TX", "zipCode": "770027900", "telephone": "", "fax": "", "website": "", "firstName": "", "middleName": "", "lastName": "", "email": "", "sic": "", "totalEmployees": "", "salesRevenue": "", "headQuarter": "", "ncoa": "", "dateAcquired": "2023-07", "ncoaUpdateDate": "2024-06", "otherPossibleNames": "", "ncoaStatus": "V", "ncoaMatchFlag": "" } } } ::: ## Error Handling :::CodeblockTabs 409 - upstream down ```json { "error": { "name": "error", "message": "Error in getting data from Upstream", "status": 409, "reason": "ERROR", "type": "Conflict", "statusCode": 409 } } ``` 500 - server error ```json { "error": { "name": "error", "message": "Internal Server Error", "status": 500, "reason": "ERROR", "type": "Conflict", "statusCode": 500 } } ``` 400 - search id is emp ```json { "error": { "name": "error", "message": "searchId is required", "status": 400, "reason": "VALIDATION_ERROR", "type": "Bad Request", "statusCode": "400" } } ``` 404 - data not found ```json { "error": { "name": "error", "message": "Data Not Found", "status": 404, "reason": "Not Found", "type": "Not Found", "statusCode": 200 } } ``` ::: :::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! :::