EIN Search APIs

EIN Business Details API

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
Pre Prod
Prod
curl --location 'https://api-preproduction.signzy.us/api/v3/us-api/us-kyb/ein-business-details' \
--header 'Authorization: <auth-token>' \
--header 'x-client-unique-id: <client id>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "searchId": "905686",
    "companyId": "70615813"
}'
curl --location 'https://api-preproduction.signzy.us/api/v3/us-api/us-kyb/ein-business-details' \
--header 'Authorization: <auth-token>' \
--header 'x-client-unique-id: <client id>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "searchId": "905686",
    "companyId": "70615813"
}'
﻿
Request Parameters
Parameter
Type
Required
Description
Example
searchLogID
Number
Yes
ID obtained from the initial EIN search API - Step 1 result. 
905686
companyId
Number
Yes
Unique ID of the company obtained from initial search - Step 1 result.
70615813
Response Format
Successful Response
Response
{
  "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": ""
    }
  }
}
{
  "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
{
  "searchLogID": 905686,
  "companyId": 70615813
}
Response Example
{
  "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
409 - upstream down
500 - server error
400 - search id is emp
404 - data not found
{
    "error": {
        "name": "error",
        "message": "Error in getting data from Upstream",
        "status": 409,
        "reason": "ERROR",
        "type": "Conflict",
        "statusCode": 409
    }
}
{
    "error": {
        "name": "error",
        "message": "Error in getting data from Upstream",
        "status": 409,
        "reason": "ERROR",
        "type": "Conflict",
        "statusCode": 409
    }
}
﻿
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	Required	Description	Example
searchLogID	Number	Yes	ID obtained from the initial EIN search API - Step 1 result.	905686
companyId	Number	Yes	Unique ID of the company obtained from initial search - Step 1 result.	70615813

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.

Did this page help you?

Technical FAQs

EIN Search API