---
title: US EIN Search Premium
slug: us-apis/us-ein-search-premium
description: Learn about the importance of an Employer Identification Numbers (EIN) for businesses and organizations in the US. Discover the EIN Verification API, a tool that validates the accuracy of EINs against official records. Explore practical examples of its ap
createdAt: 2023-09-01T07:10:06.587Z
---

Introduction

The US EIN Search Premium API enables users to verify Employer Identification Numbers (EIN) and Tax Identification Numbers (TIN) against existing records. This API is can help businesses and financial institutions to ensure the authenticity of tax-related information provided by companies.

### Use Cases

- **Tax Compliance**: Facilitates tax compliance by allowing businesses to validate TINs and EINs against IRS records, ensuring all tax-related documents are accurate.
- **Fraud Prevention**: Assists in detecting and preventing tax fraud by verifying the accuracy of TIN and EIN details submitted by businesses.
- **Business Verification**: Enables verification of business legitimacy through TIN/EIN matching, crucial for due diligence and risk assessment.

## API Details

### Request Body

::::Tabs
:::Tab{title="Pre-Production"}
```curl
curl --location 'https://api-preproduction.signzy.app/api/v3/us/ein-search-premium' \
--header 'Authorization: <auth_token>' \
--header 'Content-Type: application/json' \
--data '{
    "ein": "133429115",
    "company": "PHILIPS NORTH AMERICA LLC"
}'
```
:::

:::Tab{title="Production"}
```curl
curl --location 'https://api.signzy.us/api/v3/us/ein-search-premium' \
--header 'Authorization: xx' \
--header 'Content-Type: application/json' \
--data '{
    "ein": "133429115",
    "company": "PHILIPS NORTH AMERICA LLC"
}'
```
:::
::::

### Request Body Parameters

| **Parameter** | **Type** | **Description**                                    | **Required** |
| ------------- | -------- | -------------------------------------------------- | ------------ |
| ein           | String   | The EIN number. Should be 9 digits numeric string. | Yes          |
| company       | String   | Company name associated with the EIN               | Yes          |

:::CodeblockTabs
Match Found

```json
{
    "result": {
        "responseCode": "2",
        "responseMessage": "EIN and Name combination matches IRS EIN records.",
        "responseDesc": "VALID return code."
    },
    "reason": "Request Successful",
    "code": "S001"
}
```

Data Not Found

```json
{
  "result": {},
  "reason": "No data found for the given EIN and Company",
  "code": "S003"
}
```

Match Not Found

```json
{
  "result": {},
  "reason": "No matching company name found for the given EIN",
  "code": "S003"
}
```
:::

### Response Body Parameters

**Top-Level Object Fields**

| **Field** | **Type** | **Description**                                                             |
| --------- | -------- | --------------------------------------------------------------------------- |
| result    | Object   | Container for all the response details from the EIN premium search request. |
| reason    | String   | High-level status message indicating the overall outcome of the request.    |
| code      | String   | Response code representing the request result.                              |

**Result Details**

| **Field**       | **Type** | **Description**                                                                                                                                                                                                                                                                                                                                            |
| --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| responseCode    | String   | Normalized status code representing the outcome of the EIN and Name match against IRS records.<br />Possible values are "0", "1", "2", and "3" - where "0" = matches our records, "1" = matches IRS SSN records,<br />"2" = matches IRS EIN records, and "3" = matches both IRS SSN and EIN records.<br />All returned codes represent a successful match. |
| responseMessage | String   | Human-readable message explaining the match result corresponding to the responseCode<br /> For example, "EIN and Name combination matches our records."                                                                                                                                                                                                    |
| responseDesc    | String   | Short classification of the return code that qualifies the result, such as<br />"VALID return code."<br />, indicating whether the response is a valid/served outcome.                                                                                                                                                                                     |

### Error Code and Mapping

### Sample Error

:::CodeblockTabs
Invalid EIN Format - 400

```json
{
  "result": {},
  "reason": "Bad Request: Bad Request. EIN is not correct. Please make sure it is a 9 digit numeric value. No alphabets or special characters allowed.",
  "code": "E001"
}
```

Upstream Error 409

```json
{
  "result": {},
  "reason": "Error in getting data from Upstream",
  "code": "E401"
}
```
:::

### Error Response Parameters

| **Parameter** | **Description**                                                                                                    |
| ------------- | ------------------------------------------------------------------------------------------------------------------ |
| result        | Always returned as an empty object for error responses, as no EIN search data is available when the request fails. |
| reason        | Description of why the request failed.                                                                             |
| code          | Standardized Signzy error code identifying the failure category.                                                   |



:::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!
:::

