# Israel

Israel eKYB validates the legitimacy of Israeli businesses by checking their tax ID, business name, and address against Israeli government sources of truth.

UBOs and directors are not currently supported for Israel. 

## Source

| Country | Source                              | Description                                                                            |
| ------- | ----------------------------------- | -------------------------------------------------------------------------------------- |
| Israel  | Israeli government sources of truth | Verifies submitted business details against records maintained in Israeli registries.  |

## Direct API approach

For general integration notes and shared response semantics, see the [eKYB API Reference](https://developer.incode.com/docs/ekyb-api-reference).

### Request parameters

| Parameter      | Required  | Description                                                                                                                                                           |
| -------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `plugins`      | Mandatory | Array. Must be `["ekyb"]`.                                                                                                                                            |
| `businessName` | Mandatory | String. Name of the business.                                                                                                                                         |
| `country`      | Mandatory | String. Two-letter Alpha-2 country code. Must be `IL`.                                                                                                                |
| `taxId`        | Mandatory | String. Mispar Osek (מספר עסק), the 9-digit Israeli VAT registration number. The first digit indicates the entity type; the remaining digits are a unique identifier. |
| `street`       | Optional  | String. Street name of the business.                                                                                                                                  |
| `houseNo`      | Optional  | String. Building or house number.                                                                                                                                     |
| `addressLine2` | Optional  | String. Second line of the business address.                                                                                                                          |
| `city`         | Optional  | String. City in the business address.                                                                                                                                 |
| `state`        | Optional  | String. State in the business address.                                                                                                                                |
| `postalCode`   | Optional  | String. Israeli postal code.                                                                                                                                          |

### Sample request

```json
{
  "plugins": ["ekyb"],
  "businessName": "אי. אם. טי הפצה ולוגיסטיקה בי אנד בי בע״מ",
  "street": "חומה ומגדל",
  "houseNo": "22",
  "city": "תל אביב - יפו",
  "state": "ישראל",
  "country": "IL",
  "taxId": "XXXXXXXXX"
}
```

### Sample response

```json
{
  "kyb": [
    { "key": "name", "sub_label": "Verified" },
    { "key": "tin", "sub_label": "Verified" },
    { "key": "address_verification", "sub_label": "Verified" },
    { "key": "cityMatch", "sub_label": "Verified" },
    { "key": "registrationStatus", "sub_label": "Active" },
    {
      "key": "entityType",
      "entityType": { "entityType": "Israeli Private Company" }
    }
  ]
}
```

### Response fields

| Key                    | Status                                        | Description                                                                               |
| ---------------------- | --------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `name`                 | `Verified`, `Approximate Match`, `Unverified` | Submitted business name against the business name associated with the tax ID.             |
| `tin`                  | `Verified`, `Unverified`                      | Submitted tax ID against the government database.                                         |
| `address_verification` | `Verified`, `Approximate Match`, `Unverified` | Submitted address against the address associated with the tax ID.                         |
| `cityMatch`            | `Verified`, `Approximate Match`, `Unverified` | Submitted city against the city associated with the tax ID.                               |
| `registrationStatus`   | `Active`, `Inactive`                          | Registration status of the business.                                                      |
| `entityType`           | Legal entity type of the business             | The legal entity type of the company, if available. If not available, displays `Unknown`. |

### Error responses

See the [eKYB API Reference](https://developer.incode.com/docs/ekyb-api-reference) for standard error responses.

## Single Session Dashboard results

View eKYB results on the Business tab in [single Session view](https://developer.incode.com/docs/single-session-view).