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.

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

{
  "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

{
  "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 for standard error responses.