---
title: "Ireland"
url: "https://developer.incode.com/general-reference/ireland-ekyb/"
section: "general-reference"
group: "eKYB Reference / eKYB Verification Coverage"
version: "v1.1"
status: "live"
---
# Ireland

Ireland eKYB validates the legitimacy of Irish businesses by checking their tax ID, business name, address, UBOs, and directors against Irish government-backed business registries.

## Source

| Country | Source                          | Description                                                                |
| -------- | --------------------------------- | ----------------------------------------------------------------------------- |
| Ireland  | Irish business registry sources   | Verifies submitted business details against records maintained in Irish registries, covering both limited companies and sole trader / business name registrations. |

## Direct API approach

For general integration notes and shared response semantics, see the [eKYB API Reference](/general-reference/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 `IE`.                                                |
| `taxId`         | Mandatory | String. Accepts a CRO number or a VAT number. See [Tax ID formats](#tax-id-formats) for details.      |
| `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. Irish Eircode. See format note below.                                                          |
| `uboNames`      | Optional  | Array. Full legal names of Unique Beneficial Owners to check against records associated with the business. |
| `directors`     | Optional  | Array. Full legal names of directors to check against records associated with the business.           |



#### Tax ID formats

| Tax ID Type  | Format                                                                     |
| ------------- | ----------------------------------------------------------------------------- |
| CRO number    | 5–9 numeric digits (for example, `123456`). Issued by the Companies Registration Office. |
| VAT number    | `IE` + 7 digits + 1–2 check letters (for example, `IE1234567X`). The `IE` prefix is stripped before matching. |





### Sample request

```json
{
  "plugins": ["ekyb"],
  "businessName": "ACME TRADING LIMITED",
  "street": "Harbour Road",
  "houseNo": "12",
  "city": "Cork",
  "postalCode": "T12A1B2",
  "country": "IE",
  "taxId": "123456",
  "uboNames": ["Jane Doe", "John Doe"],
  "directors": ["Jane Doe"]
}
```

### 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": "postalCodeMatch", "sub_label": "Verified" },
    { "key": "registrationStatus", "sub_label": "Active" },
    {
      "key": "entityType",
      "entityType": { "entityType": "LTD - PRIVATE COMPANY LIMITED BY SHARES" }
    },
    { "key": "directors_name_match", "sub_label": "Verified", "directorsName_input": "Jane Doe" },
    { "key": "ubo_name_match", "sub_label": "Unverified", "uboName_input": "John Doe" }
  ]
}
```

### Response fields

| Key                     | Status                                    | Description                                                                                       |
| ------------------------ | -------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `name`                  | Verified, Approximate Match, Unverified      | Submitted business name against the registered legal name.                                         |
| `tin`                   | Verified, Unverified                          | Submitted tax ID (CRO or VAT number) against the registry.                                          |
| `address_verification`  | Verified, Approximate Match, Unverified      | Submitted address against the registered address on file. Matched as a fuzzy match on the full address; the postal code is an Eircode, not a fixed-digit numeric format. |
| `cityMatch`             | Verified, Approximate Match, Unverified      | Submitted city against the city on the registered address.                                          |
| `postalCodeMatch`       | Verified, Unverified                          | Submitted Eircode against the Eircode on the registered address.                                    |
| `registrationStatus`    | Active, Inactive, Unknown                     | Registration status of the business. Inactive includes suspended businesses and those no longer in operation. |
| `entityType`            | Legal entity type of the business             | The legal entity type of the business, if available (for example, a limited company form, or an individual/sole trader designation). If not available, displays Unknown. |
| `ubo_name_match`        | Verified, Approximate Match, Unverified      | Submitted UBO against shareholders/UBOs associated with the business. Distinguished by the `uboName_input` field on each entry. May return `Unverified` for sole trader businesses that have no shareholder structure. |
| `directors_name_match`  | Verified, Approximate Match, Unverified      | Submitted director against directors (or, for sole traders, the registered business owner) associated with the business. Distinguished by the `directorsName_input` field. A single person may appear more than once under different position titles; all entries are checked. |

## Error responses

See the [eKYB API Reference](/general-reference/ekyb-api-reference/) for standard error responses.