> ## Documentation Index > Fetch the complete documentation index at: https://developer.kyckr.com/llms.txt > Use this file to discover all available pages before exploring further. # Ireland Company Data – Search, Lite Profile, Enhanced Profile, and Business Name Support > Ireland Search, Lite Profile, and Enhanced Profile responses updated with improved data quality, additional fields, and new Business Name entity support. ## Overview We've updated Search, Lite Profile, and Enhanced Profile responses for Ireland (ISO code IE) with improved data quality and additional fields across all products. This update also introduces Business Name entity support. ### Key points * **Search**: `codeField` now includes an entity type prefix (`C` for CRO Company, `B` for Business Name) — unprefixed values continue to work for backward compatibility * **Lite Profile**: Improved address parsing, populated `activityField`, `foundationDateField`, cleaner `legalFormField`, normalized legal status, and `aliasesField` * **Activity field**: `activityField` now carries a NACErev2 code and description sourced from CRO open data. Available for companies registered during or after 2015 — earlier registrations typically won't have a NACErev2 code. * **Enhanced Profile**: Same improvements as Lite, plus populated `activityField`, `activityDeclarationField`, `capitalField`, `lastAnnualAccountDateField`, and enriched `directorAndShareDetailsField` * **Activity field**: When CRO provides a NACE code, only that NACE code is returned. When NACE is unavailable, the SIC07 code and description (extracted from A1 form text) is returned alongside an inferred NACE mapping (`typeField: "PrimaryInferred"`). If the SIC → NACE mapping is unclear, only the SIC code is returned. * **Business Names**: New entity type — use `B`-prefixed `codeField` from search results to order Business Name profiles ## Search results ### codeField format change The `codeField` (the proprietary identifier used to order profiles) now includes an entity type prefix. **Before:** ```json theme={null} { "companiesField": [ { "codeField": "234567", "nameField": "ATLANTIC TRADING LIMITED" } ] } ``` **After:** ```json theme={null} { "companiesField": [ { "codeField": "C234567", "nameField": "ATLANTIC TRADING LIMITED" } ] } ``` The prefix indicates the entity type: | Prefix | Entity Type | Example | | ------ | ------------- | --------- | | `C` | CRO Company | `C234567` | | `B` | Business Name | `B345678` | **Backward compatibility:** Unprefixed `codeField` values continue to work and will return the CRO company profile. However, customers should update their integration to use the new prefixed values from search results. The prefix is required to distinguish between CRO Companies and Business Names — without the prefix, only the CRO company is returned. ## Lite profile changes The Lite Profile response has been improved with better address parsing, additional fields, and cleaner data formatting. ### Response structure changes **Before:** ```json theme={null} { "companyProfileField": { "activityField": [ {"codeField": "", "descriptionField": ""} ], "addressesField": [ { "addressInOneLineField": "HARBOUR BUSINESS CENTRE, INDUSTRIAL ESTATE, CORK ROAD WATERFORD, CO WATERFORD, WATERFORD, IRELAND, IRELAND", "addressLine1Field": "HARBOUR BUSINESS CENTRE", "addressLine2Field": "INDUSTRIAL ESTATE", "addressLine3Field": "CORK ROAD WATERFORD", "addressLine4Field": "", "cityTownField": "", "postcodeField": "", "regionStateField": "" } ], "codeField": "234567", "foundationDateField": "", "legalFormField": "1153", "legalFormDeclarationField": "LTD - Private Company Limited by Shares", "legalStatusField": "Normal ", "normalizedLegalStatusField": "ACTIVE", "nameField": "ATLANTIC TRADING LIMITED", "registrationAuthorityField": "Companies Registration Office Ireland", "registrationDateField": "2010-06-15T00:00:00Z" } } ``` **After:** ```json theme={null} { "companyProfileField": { "activityField": [ { "codeField": "8690", "descriptionField": "Other human health activities", "classificationSchemeField": "NACErev2" } ], "addressesField": [ { "countryField": "Ireland", "typeField": "Registered Address", "addressInOneLineField": "123 main street, Enterprise Business Park, Naas, KILDARE, W12 X123, Ireland", "addressLine1Field": "123 main street, Enterprise Business Park", "cityTownField": "Naas, KILDARE, W12 X123", "postcodeField": "W12 X123" } ], "aliasesField": [], "codeField": "234567", "dateField": "2026-04-28T13:15:14.1670560Z", "foundationDateField": "2023-06-09", "legalFormField": "LTD - Private Company Limited by Shares", "legalStatusField": "Normal", "normalizedLegalStatusField": "Active", "nameField": "ATLANTIC TRADING LIMITED", "officialField": false, "registrationAuthorityField": "Companies Registration Office Ireland", "registrationDateField": "2023-06-09", "registrationNumberField": "234567" }, "transactionIdField": "346351", "responseCodeField": "100" } ``` ### Key changes #### Address parsing * **`cityTownField`**, **`regionStateField`**: Now populated (previously empty) * **`typeField`**: New — populated with `"Registered Address"` * **`addressLine2Field`** through **`addressLine4Field`**: Removed #### Date fields * **`foundationDateField`**: Now populated with the company's foundation date in ISO format * **`registrationDateField`**: Clean ISO date (removed `"T00:00:00Z"` suffix) #### Legal form and status * **`legalFormField`**: Now contains the full legal form text (previously numeric code only, e.g., `"1153"`) * **`legalFormDeclarationField`**: Removed — `legalFormField` now carries the full text * **`legalStatusField`**: Trimmed trailing whitespace (`"Normal "` → `"Normal"`) * **`normalizedLegalStatusField`**: Now uses title case (`"Active"` instead of `"ACTIVE"`) #### New fields * **`aliasesField`**: Now populated with company aliases where available * **`registrationNumberField`**: Now populated with the registration number * **`activityField`**: Now populated with `codeField`, `descriptionField`, and `classificationSchemeField` (`NACErev2`) for companies registered during or after 2015 #### Activity data `activityField` is now populated for Lite Profile responses. Each entry contains: * **`codeField`** — the NACErev2 code * **`descriptionField`** — human-readable description of the activity * **`classificationSchemeField`** — always `"NACErev2"` for Lite Profile This data is sourced from CRO open data. NACErev2 codes are reliably available for companies with a registration date during or after 2015. Companies registered before 2015 will most likely have an empty `activityField`. ## Enhanced profile changes The Enhanced Profile includes all Lite Profile improvements above, plus the following additional enrichments. ### Response structure changes **Before** (key fields): ```json theme={null} { "companyProfileField": { "activityField": [ { "codeField": "70100", "descriptionField": "Activities of head offices" } ], "addressesField": [ { "countryField": "IRELAND", "addressInOneLineField": "132 MAIN STREET, PINKROCK, DUBLIN, A94X051, IRELAND, IRELAND", "addressLine1Field": "132 MAIN STREET", "addressLine2Field": "PINKROCK, DUBLIN, A94X051, IRELAND", "addressLine3Field": "", "addressLine4Field": "" } ], "codeField": "234567", "dateField": "2026-04-28T12:19:41.5094645Z", "lastAnnualAccountDateField": "2024-09-04T01:00:00Z", "legalFormField": "1157", "legalFormDeclarationField": "ULC - Private Unlimited Company", "legalStatusField": "Normal ", "normalizedLegalStatusField": "ACTIVE", "nameField": "ATLANTIC TRADING LIMITED", "officialField": false, "registrationAuthorityField": "Companies Registration Office Ireland", "registrationDateField": "2013-09-05T00:00:00Z", "directorAndShareDetailsField": { "directorsField": [ { "titleField": "Director", "nameField": "JOE BLOGGS", "address1Field": "1 EXAMPLE STREET", "address2Field": "PINKROCK", "address3Field": "CO.DUBLIN", "address4Field": "", "address5Field": "", "address6Field": "", "postcodeField": "", "birthdateField": "13/05/1963", "nationalityField": "", "directorshipsField": [ { "companyNumberField": "234567", "companyNameField": "ATLANTIC TRADING LIMITED", "companyStatusField": "Active - Accounts Filed", "functionField": "Director", "appointedDateField": "10/12/2013" }, { "companyNumberField": "345678", "companyNameField": "EXAMPLE COMPANY ONE", "companyStatusField": "Active - Accounts Filed", "functionField": "Director", "appointedDateField": "27/08/2014" }, { "companyNumberField": "456789", "companyNameField": "EXAMPLE COMPANY TWO", "companyStatusField": "Active - Accounts Filed", "functionField": "Director", "appointedDateField": "29/08/2014" } ] } ], "shareHoldersField": [ { "nameField": "EXAMPLE COMPANY", "percentageField": "99", "allInfoField": "99.00 ORDINARY EUR 1.00", "currencyField": "EUR", "nominalValueField": "1", "shareCountField": 99, "shareTypeField": "ORDINARY", "shareholderTypeField": "Company", "totalShareCountField": 100, "totalShareValueField": 100, "totalSharesField": 100, "percentageIsRangeField": false }, { "nameField": "JOE BLOGGS", "percentageField": "1", "allInfoField": "1.00 ORDINARY EUR 1.00", "currencyField": "EUR", "nominalValueField": "1", "shareCountField": 1, "shareTypeField": "ORDINARY", "shareholderTypeField": "Person", "totalShareCountField": 100, "totalShareValueField": 100, "totalSharesField": 100, "percentageIsRangeField": false } ], "shareHolderSummaryField": { "shareCapitalField": "100" } } } } ``` **After** (key fields, retrieved with `showDirectorships=true`): ```json theme={null} { "companyProfileField": { "activityField": [ { "codeField": "70100", "descriptionField": "Activities of head offices", "classificationSchemeField": "SIC07", "typeField": "Primary" }, { "codeField": "7010", "descriptionField": "Activities of head offices", "classificationSchemeField": "NACErev2", "typeField": "PrimaryInferred" } ], "activityDeclarationField": [ { "declarationField": "Provision of management services to other group companies.", "declarationDescriptionField": "Principal Activity", "languageField": "en" } ], "addressesField": [ { "countryField": "Ireland", "typeField": "Registered Address", "addressInOneLineField": "1 MAIN STREET, PINKROCK DUBLIN IRELAND, A94X051", "addressLine1Field": "1 MAIN STREET PINKROCK, DUBLIN, A94X051, IRELAND", "postcodeField": "A94X051" } ], "capitalField": [ { "ammountField": "100.00", "currencyField": "EUR", "typeField": "ORDINARY", "typeCodeField": "ORDINARY", "shareQuantityField": 100 } ], "codeField": "234567", "dateField": "2026-04-28T12:22:40.8958368Z", "lastAnnualAccountDateField": "2024-09-04", "legalFormField": "ULC - Private Unlimited Company", "legalFormDeclarationField": "ULC - Private Unlimited Company", "legalStatusField": "Normal", "normalizedLegalStatusField": "Active", "nameField": "ATLANTIC TRADING LIMITED", "officialField": false, "registrationAuthorityField": "Companies Registration Office Ireland", "registrationDateField": "2013-09-05", "registrationNumberField": "234567", "directorAndShareDetailsField": { "directorsField": [ { "directorNumberField": "123456789", "titleField": "Director", "nameField": "JOE BLOGGS", "address1Field": "1 EXAMPLE STREET, PINKROCK", "address2Field": "CO.DUBLIN", "birthdateField": "1964-09", "appointedOnField": "2013-12-10", "directorshipsField": [ { "companyNumberField": "234567", "companyNameField": "ATLANTIC TRADING LIMITED", "functionField": "Director", "appointedDateField": "2013-12-10" }, { "companyNumberField": "345678", "companyNameField": "EXAMPLE COMPANY ONE", "functionField": "Director", "appointedDateField": "2014-08-27" }, { "companyNumberField": "456789", "companyNameField": "EXAMPLE COMPANY TWO", "functionField": "Director", "appointedDateField": "2014-08-29" } ] } ], "shareHoldersField": [ { "nameField": "EXAMPLE COMPANY", "percentageField": "99.00", "currencyField": "EUR", "nominalValueField": "99", "shareClassField": "ORDINARY", "shareCountField": 99, "shareTypeField": "ORDINARY", "shareholderTypeField": "Company", "totalShareCountField": 100, "totalShareValueField": 100, "percentageIsRangeField": false }, { "nameField": "JOE BLOGGS", "percentageField": "1.00", "currencyField": "EUR", "nominalValueField": "1", "shareClassField": "ORDINARY", "shareCountField": 1, "shareTypeField": "ORDINARY", "shareholderTypeField": "Person", "totalShareCountField": 100, "totalShareValueField": 100, "percentageIsRangeField": false } ] } } } ``` ### showDirectorships query parameter The `directorshipsField` array was previously included in Enhanced Profile responses by default. It is now opt-in — if you need this data, you must pass the `showDirectorships=true` query parameter on your Enhanced Profile request. ```bash theme={null} # Enhanced Profile with directorships (V1) curl -X GET "https://rest.kyckr.com/core/company/profile/IE/C234567?showDirectorships=true" \ -H "Authorization: YOUR_API_KEY" \ -H "Accept: application/json" ``` #### How it works | Value | Behavior | | ------------------------- | ------------------------------------------------------------------------------ | | `showDirectorships=true` | `directorshipsField` is populated with each director's other company positions | | `showDirectorships=false` | `directorshipsField` is empty or omitted | | Parameter omitted | Same as `false` — `directorshipsField` is empty or omitted | **Availability**: Currently supported for UK/IE companies (ISO code GB/IE) only. ### Key changes #### Activity data * **`activityField`**: Now populated with NACErev2 / SIC07 codes — `codeField`, `descriptionField`, `classificationSchemeField`, and `typeField` (new value: `"PrimaryInferred"`) * **`activityDeclarationField`**: New — principal activity descriptions in natural language The classification scheme returned depends on the data available: * If a NACE code is available from CRO, only that NACE code is returned (`classificationSchemeField: "NACErev2"`, `typeField: "Primary"`). * If NACE is not available but a SIC code can be extracted from the A1 form text, the SIC07 code and description are returned (`classificationSchemeField: "SIC07"`, `typeField: "Primary"`) alongside an inferred NACE mapping (`classificationSchemeField: "NACErev2"`, `typeField: "PrimaryInferred"`). * If a clean SIC → NACE mapping isn't possible, only the SIC code is returned. #### Financial data * **`capitalField`**: New — share class information with `ammountField`, `currencyField`, `shareQuantityField`, and `typeField` * **`lastAnnualAccountDateField`**: Clean ISO date (removed `"T00:00:00Z"` suffix) #### Directors * **`birthdateField`**: Now month/year only (`"1980-11"` instead of `"DD/MM/YYYY"`) * **`appointedOnField`**: Now populated with ISO date (previously empty) * **`directorNumberField`**: New — unique identifier for the individual * Corporate representatives (Ultimate Parent, Immediate Parent) now included in `directorsField` with `registrationNumberField` #### Shareholders * **`shareClassField`**: New — share class type * **`shareCountField`**: New — number of shares held * **`idField`**: New — shareholder registration number * **`nominalValueField`**: Now reflects correct total nominal value ## Business Name support Previously, ordering a profile using an Irish Business Name registration number returned the CRO company associated with that number. Business Name entities are now properly supported. ### How it works Search results now include both CRO Companies and Business Names, distinguished by the `codeField` prefix: | Prefix | Entity Type | Example | | ------ | ------------- | --------- | | `C` | CRO Company | `C234567` | | `B` | Business Name | `B345678` | * Use the `B`-prefixed `codeField` to order a Business Name profile * Use the `C`-prefixed `codeField` to order the CRO company profile * Unprefixed values return the CRO company (backward compatible) ### Key characteristics of Business Name profiles * **`legalFormField`** shows Business Name types (e.g., `"Business name - Body Corporate"`, `"Business name - Individual"`) * **`directorAndShareDetailsField.directorsField`** uses `"Registered Business Owner"` role instead of Director/Secretary ## Filings ### Companies #### Date format change The display date in filing list responses is now formatted as `YYYY-MM-DD` (previously `MM-DD-YYYY`). #### Deprecated fields The following field has been deprecated and will be removed in a future release: ```json theme={null} { "productDetailsField": [ { "valueField": "2025-11-10", "documentCountField": 0 } ] } ``` ### Business Names Three new filings are now returned in the filing list for Business Name entities: * **Business Name Profile** * **Business Name Registration Form** * **Certificate of Registration** The `companyCodeField` for these filings is prefixed with `B`. | Detail | Value | | ------------- | -------------------- | | Cost | 5 credits per filing | | Delivery time | Within 15 minutes | ## Additional resources * [Lite Profile Documentation](/documentation/features/verify-basic-details-v1) * [Enhanced Profile Documentation](/documentation/features/perform-a-kyb-check-v1) * [Search API Documentation](/documentation/features/search-for-a-company-v1)