EIN Search APIs

EIN Search API

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
Pre Prod
Prod
curl --location 'https://api.signzy.us/api/v3/us-kyb/ein-search' \
--header 'Authorization: <auth code>' \
--header 'x-client-unique-id: <client id>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ein": "<sample id>",
    "company": "<sample company name>"
}'
curl --location 'https://api.signzy.us/api/v3/us-kyb/ein-search' \
--header 'Authorization: <auth code>' \
--header 'x-client-unique-id: <client id>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ein": "<sample id>",
    "company": "<sample company name>"
}'
﻿
Request Parameters
Parameter
Type
Required
Description
ein
String
No
EIN to validate
companyName
String
No
Company name to validate
Note: At least one parameter (ein or companyName) must be provided.
Response Format
Successful Response (status: "Success")
Response
{
  "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": ""
      }
    ]
  }
}
{
  "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:
{
  "ein": "123456789"
}
Response:
{
  "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:
{
  "companyName": "KELLOGG BROWN & ROOT LLC"
}
Response:
{
  "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
404 (data not found using EIN)
404 (data not found using company name)
500 (server error)
409 (upstream issue)
{
    "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
ein	String	No	EIN to validate
companyName	String	No	Company name to validate

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.

Did this page help you?

EIN Business Details API

Signzy Document Auto Capture