> ## 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 significantly expanded Ireland (IE) company data across Lite and Enhanced Profiles with improved data. This update delivers richer data quality, introduces Business Name entity support, and adds an optional address geocoding enrichment for Enhanced Profiles. ### Key points * **Lite Profile**: Structured address parsing, populated `activity`, `otherIdentifiers` array, `aliases` with structured objects, cleaner dates and legal forms * **Activity**: `activity` 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**: New fields — `activities`, `activityDeclarations`, `lastAnnualAccountDate`, `totalCapital`, corporate representatives (Ultimate Parent, Immediate Parent) * **Activities**: 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 (`type: "PrimaryInferred"`). If the SIC → NACE mapping is unclear, only the SIC code is returned. * **Business Names**: New entity type — Business Name registration numbers now return correct data with `B` prefix identifiers * **Geocoding**: New `extend` query parameter enables address geocoding on Enhanced Profiles (per-account configuration — contact your account manager) ## Lite profile changes The Lite Profile response has been improved with structured address parsing, additional identifiers, and cleaner data formatting. ### Address structure The `address` object now includes structured fields: | Field | Status | | ----------------- | ------------------------------------------ | | `type` | New — `"Registered Address"` | | `fullAddress` | Improved formatting | | `rawAddressLines` | New — array of original address components | | `buildingName` | Now populated | | `streetName` | Now populated | | `city` | New | | `postcode` | New | | `isoCode` | New — `"IE"` | | `municipality` | New | ### Other improvements * **`activity`**: New array — populated with `code`, `description`, and `classificationScheme` (`NACErev2`) for companies registered during or after 2015 * **`otherIdentifiers`**: New array for additional company identifiers (reserved for future use) * **`aliases`**: Now contains structured objects with `name` and `type` fields (e.g., `{"name": "Example Co", "type": "Trading Name"}`) * **Date formatting**: Cleaner ISO date formatting for `foundationDate` and `registrationDate` * **`legalForm`**: Numeric prefix codes stripped (e.g., `"1153 - LTD - Private Company Limited by Shares"` → `"LTD - Private Company Limited by Shares"`) * **`legalStatus`**: `normalized` field now populated (e.g., `"Active"`) ### Activity data `activity` is now populated for Lite Profile responses. Each entry contains: * **`code`** — the NACErev2 code * **`description`** — human-readable description of the activity * **`classificationScheme`** — always `"NACErev2"` for Lite Profile * **`type`** — typically `"Primary"` 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 `activity` array. #### Sample response ```json theme={null} { "data": { "activity": [ { "code": "8690", "description": "Other human health activities", "classificationScheme": "NACErev2", "type": "Primary" } ], "address": { "identifier": "IE-EXAMPLE0000000000000000000000000000000", "type": "Registered Address", "fullAddress": "123 MAIN STREET, ENTERPRISE BUSINESS PARK, NAAS, KILDARE, W12 X123, Ireland", "rawAddressLines": [ "123 MAIN STREET", "ENTERPRISE BUSINESS PARK", "NAAS, KILDARE, W12 X123, Ireland" ], "buildingName": "123 MAIN STREET", "streetName": "ENTERPRISE BUSINESS PARK", "city": "NAAS, KILDARE, W12 X123", "postcode": "W12 X123", "country": "Ireland", "isoCode": "IE" }, "companyNumber": "234567", "companyName": "ATLANTIC TRADING LIMITED", "foundationDate": { "original": "2023-06-09", "normalized": "2023-06-09" }, "registrationDate": { "original": "2023-06-09", "normalized": "2023-06-09" }, "legalForm": { "original": "LTD - Private Company Limited by Shares" }, "legalStatus": { "original": "Normal", "normalized": "Active" }, "registrationAuthority": "Companies Registration Office Ireland" } } ``` ## Enhanced profile changes The Enhanced Profile has been substantially enriched with new fields, improved data quality, and corporate representative data. ### New fields | Field | Description | Example | | ----------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | `activities` | NACErev2 / SIC07 classification (see [Activity data](#activity-data-1)) | `{"code": "6201", "classificationScheme": "NACErev2", "type": "Primary"}` | | `activityDeclarations` | Principal activity in natural language | `{"declaration": "Development and distribution of software solutions.", "declarationDescription": "Principal Activity", "language": "en"}` | | `lastAnnualAccountDate` | Most recent annual account filing | `{"normalized": "2024-09-30", "original": "2024-09-30"}` | | `totalCapital` | Aggregate capital summary | `{"currency": "EUR", "quantity": 3786684, "totalValue": 1893342}` | ### Activity data The `activities` array uses different classification schemes depending on the data available from CRO: * If a NACE code is available from CRO, only that NACE code is returned (`classificationScheme: "NACErev2"`, `type: "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 (`classificationScheme: "SIC07"`, `type: "Primary"`) alongside an inferred NACE mapping (`classificationScheme: "NACErev2"`, `type: "PrimaryInferred"`). * If a clean SIC → NACE mapping isn't possible, only the SIC code is returned. Example showing both SIC07 and inferred NACErev2: ```json theme={null} { "activities": [ { "code": "46140", "description": "Agents involved in the sale of machinery, industrial equipment, ships and aircraft", "classificationScheme": "SIC07", "type": "Primary" }, { "code": "4614", "description": "Agents involved in the sale of machinery, industrial equipment, ships and aircraft", "classificationScheme": "NACErev2", "type": "PrimaryInferred" } ] } ``` The accompanying `activityDeclarations` array carries principal activity descriptions in natural language and is unchanged in structure. ### Enhanced existing fields #### Addresses * `city`, `isoCode`, `municipality`, `postcode`, `rawAddressLines`, and `type` (`"Registered Address"`) are now populated * `identifier` format updated (now includes ISO country prefix, e.g., `"IE-..."`) and links addresses to the `additionalInformation.addressInformation` geocoding response (see [Geocoding](#geocoding--extend-query-parameter)) #### Capital * `classDescription`, `description`, `totalNominalValue`, `unitNominalValue`, and `votingRights` are now populated #### Representatives * Now includes `corporations` array alongside `individuals` * Corporate representatives include Ultimate Parent and Immediate Parent entities with `registeredAddress`, `registrationNumber`, and `isoCode` * Individual representatives now use an `address` object (with `type`, e.g., `"Service Address"`) instead of the previous `placeOfResidence` structure * New fields on individuals: `startDate`, `idNumber`, `birthdate` (month/year only), `municipality` * `directorships` array was previously included by default but is now opt-in — if this data is of interest, you must pass the `showDirectorships=true` query parameter to include it in the response ### showDirectorships query parameter The `directorships` 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 (V2) curl -X GET "https://api.kyckr.com/v2/companies/IE|QzIzNDU2Nw==/enhanced?showDirectorships=true" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Accept: application/json" ``` #### How it works | Value | Behavior | | ------------------------- | ------------------------------------------------------------------------- | | `showDirectorships=true` | `directorships` is populated with each director's other company positions | | `showDirectorships=false` | `directorships` is empty or omitted | | Parameter omitted | Same as `false` — `directorships` is empty or omitted | **Availability**: Currently supported for UK/IE companies (ISO code GB/IE) only. ### Data quality improvements * **`legalForm`**: Numeric prefix codes stripped (`"1153 - LTD - Private Company Limited by Shares"` → `"LTD - Private Company Limited by Shares"`) * **`registrationDate`**: Cleaner format (removed `"T00:00:00Z"` suffix) * **`status`**: Trimmed trailing whitespace (`"Normal "` → `"Normal"`) ### Before/after comparison **Before** (registration 234567 — ATLANTIC TRADING LIMITED): ```json theme={null} { "addresses": [ { "buildingName": "1 MAIN STREET", "country": "IRELAND", "fullAddress": "1 MAIN STREET, PINKROCK, DUBLIN, A94X051, IRELAND, IRELAND", "identifier": "EXAMPLE0000000000000000000000000000000", "streetName": "PINKROCK" } ], "capital": [ { "classCode": "ORDINARY", "currency": "EUR", "quantity": 100.0, "shareholdings": [ { "count": 99, "percentage": "99.00", "shareholders": { "corporations": [ {"name": "EXAMPLE COMPANY ONE", "type": "Corporation"} ] }, "totalNominalValue": 1 }, { "count": 1, "percentage": "1.00", "shareholders": { "individuals": [ {"name": "JOE BLOGGS", "type": "Person"} ] }, "totalNominalValue": 1 } ], "type": "ORDINARY" } ], "companyName": "ATLANTIC TRADING LIMITED", "identifiers": {"primaryRegistrationNumber": "234567"}, "legalForm": {"original": "1157 - ULC - Private Unlimited Company"}, "registrationAuthority": "Companies Registration Office Ireland", "registrationDate": {"normalized": "2013-09-05", "original": "2013-09-05T00:00:00Z"}, "representatives": { "individuals": [ { "birthdate": {"normalized": "1963-05-13", "original": "13/05/1963"}, "directorships": [ {"companyName": "ATLANTIC TRADING LIMITED", "companyNumber": "234567", "role": "Director", "startDate": {"normalized": "2013-12-10", "original": "10/12/2013"}} ], "isActive": true, "name": "JOE BLOGGS", "placeOfResidence": { "buildingName": "1 EXAMPLE STREET", "city": "PINKROCK", "fullAddress": "1 EXAMPLE STREET, PINKROCK, CO. DUBLIN, IRELAND", "identifier": "EXAMPLE0000000000000000000000000000001", "streetName": "PINKROCK ROAD" }, "role": {"original": "Director"}, "type": "Person" } ] }, "status": {"normalized": "Active", "original": "Normal "} } ``` **After** (registration 234567 — ATLANTIC TRADING LIMITED, retrieved with `showDirectorships=true`): ```json theme={null} { "orderId": 346346, "correlationId": "EXAMPLE-CORRELATION-ID", "cost": { "type": "credit", "value": 1 }, "timeStamp": "2026-04-28T12:52:55.1578846Z", "details": "Success", "data": { "activities": [ { "code": "70100", "description": "Activities of head offices", "classificationScheme": "SIC07", "type": "Primary" }, { "code": "7010", "description": "Activities of head offices", "classificationScheme": "NACErev2", "type": "PrimaryInferred" } ], "activityDeclarations": [ { "declaration": "Provision of management services to other group companies.", "declarationDescription": "Principal Activity", "language": "en" } ], "addresses": [ { "identifier": "IE-EXAMPLE0000000000000000000000000000000", "type": "Registered Address", "fullAddress": "1 MAIN STREET, PINKROCK DUBLIN IRELAND, A94X051", "rawAddressLines": [ "1 MAIN STREET", "PINKROCK, DUBLIN, A94X051, Ireland" ], "buildingName": "1 MAIN STREET", "streetName": "PINKROCK", "postcode": "A94X051", "country": "Ireland", "isoCode": "IE" } ], "capital": [ { "type": "ORDINARY", "description": "ORDINARY", "classCode": "ORDINARY", "classDescription": "ORDINARY", "quantity": 100, "unitNominalValue": 1, "totalNominalValue": 100, "currency": "EUR", "votingRights": "Undisclosed", "shareholdings": [ { "percentage": "99.00", "count": 99, "totalNominalValue": 99, "shareholders": { "corporations": [ { "type": "Corporation", "name": "EXAMPLE COMPANY ONE" } ] } }, { "percentage": "1.00", "count": 1, "totalNominalValue": 1, "shareholders": { "individuals": [ { "type": "Person", "name": "JOE BLOGGS" } ] } } ] } ], "totalCapital": { "totalValue": 100, "quantity": 100, "currency": "EUR" }, "representatives": { "corporations": [ { "role": {"original": "Ultimate Parent"}, "isActive": true, "registrationNumber": "234570", "registeredAddress": { "identifier": "IE-EXAMPLE0000000000000000000000000000001", "fullAddress": "5 EXAMPLE PLAZA, DUBLIN, IRELAND", "country": "Ireland", "isoCode": "IE" }, "type": "Corporation", "name": "EXAMPLE HOLDINGS LIMITED" } ], "individuals": [ { "role": {"original": "Director"}, "startDate": {"original": "2013-12-10", "normalized": "2013-12-10"}, "isActive": true, "directorships": [ { "companyNumber": "234567", "companyName": "ATLANTIC TRADING LIMITED", "role": "Director", "startDate": {"original": "2013-12-10", "normalized": "2013-12-10"}, "isActive": true }, { "companyNumber": "234568", "companyName": "EXAMPLE COMPANY ONE", "role": "Director", "startDate": {"original": "2014-08-27", "normalized": "2014-08-27"}, "isActive": true }, { "companyNumber": "234569", "companyName": "EXAMPLE COMPANY TWO", "role": "Director", "startDate": {"original": "2014-08-29", "normalized": "2014-08-29"}, "isActive": true } ], "birthdate": {"original": "1963-05", "normalized": "1963-05"}, "type": "Person", "idNumber": "123456789", "name": "JOE BLOGGS", "address": { "identifier": "IE-EXAMPLE0000000000000000000000000000002", "type": "Service Address", "fullAddress": "1 EXAMPLE STREET, PINKROCK DUBLIN", "streetName": "1 EXAMPLE STREET", "postcode": "A94 V8K0", "municipality": "PINKROCK DUBLIN" } } ] }, "identifiers": { "primaryRegistrationNumber": "234567" }, "companyName": "ATLANTIC TRADING LIMITED", "registrationAuthority": "Companies Registration Office Ireland", "lastAnnualAccountDate": { "original": "2024-09-04", "normalized": "2024-09-04" }, "registrationDate": { "original": "2013-09-05", "normalized": "2013-09-05" }, "status": { "original": "Normal", "normalized": "Active" }, "legalForm": { "original": "ULC - Private Unlimited Company" } } } ``` ## Business Name support Previously, ordering a profile using an Irish Business Name registration number returned incorrect data — the CRO company associated with that number rather than the Business Name entity itself. This has been resolved. ### How it works Business Name entities are now properly distinguished from CRO companies using an identifier prefix: | Prefix | Entity Type | Example | | ------ | ------------- | --------- | | `C` | CRO Company | `C234567` | | `B` | Business Name | `B456789` | When searching, both entity types appear in results with their respective prefixed identifiers. Use the prefixed `kyckr_id` to order the correct entity type. The search search results will display the type. This will distinguish between companies and business names ### Example: Business Name profile (registration 345678) ```json theme={null} { "activityDeclarations": [ {"declaration": "DESIGN AND SUPPLY OF ELECTRONIC COMPONENTS", "declarationDescription": "Principal Activity", "language": "en"} ], "addresses": [ { "buildingName": "TECH HUB", "city": "DUBLIN 4, DUBLIN, D02XY45, IRELAND", "country": "Ireland", "fullAddress": "TECH HUB, 15 MERRION SQUARE, DUBLIN 4,DUBLIN,D02XY45,IRELAND, D02XY45", "identifier": "IE-mN3oP4qR5sT6uV7wX8yZ9aB0cD1eF2gH3iJ4kL5mN6", "isoCode": "IE", "postcode": "D02XY45", "rawAddressLines": ["TECH HUB", "15 MERRION SQUARE", "DUBLIN 4, DUBLIN, D02XY45, IRELAND"], "streetName": "15 MERRION SQUARE", "type": "Registered Address" } ], "companyName": "EMERALD SOFTWARE SOLUTIONS", "identifiers": {"primaryRegistrationNumber": "345678"}, "legalForm": {"original": "Business name - Individual"}, "registrationAuthority": "Companies Registration Office Ireland", "registrationDate": {"normalized": "2005-04-12", "original": "2005-04-12"}, "registrationType": "Business Name", "representatives": { "individuals": [ { "address": { "fullAddress": "8 SANDYMOUNT AVENUE, DUBLIN 4, D04X1Y2", "identifier": "tU7vW8xY9zA0bC1dE2fG3hI4jK5lM6nO7pQ8rS9tU0vW" }, "idNumber": "567890", "isActive": true, "name": "MICHAEL BRENNAN", "role": {"original": "Registered Business Owner"}, "startDate": {"normalized": "2005-04-12", "original": "2005-04-12"}, "type": "Person" } ] }, "status": {"normalized": "Active", "original": "Normal"} } ``` Key characteristics of Business Name profiles: * **`legalForm`** shows Business Name types (e.g., `"Business name - Body Corporate"`, `"Business name - Individual"`) * **`registrationType`** is populated with `"Business Name"` * **Representatives** use `"Registered Business Owner"` role instead of Director/Secretary ## Geocoding — `extend` query parameter (Beta) > **Beta trial** — The `extend` parameter is in beta. Its interface and available extension types are subject to change. A new optional query parameter `extend` on V2 Enhanced Profile enables optional profile extensions. Pass a comma-separated list of extension types — `geocoding` is the first available type. ### ⚠️ Controlled access feature * Customers must **contact their account manager** to get geocoding enabled for their account * This is a **per-account configuration** — not available to all customers by default * **Additional cost may apply** * If a customer requests an extension type they don't have access to, the value is silently ignored — **no error code, no rejection** ### Request ```http theme={null} GET /company/v2/ie/{kyckr_id}/enhanced?extend=geocoding ``` ### Response structure When enabled, the Enhanced Profile response includes an `additionalInformation` object with geocoded and parsed addresses: ```json theme={null} { "addressInformation": { "addresses": [ { "identifier": "IE-aB3cD4eF5gH6iJ7kL8mN9oP0qR1sT2uV3wX4yZ5aB6", "variants": [ { "type": "Parsed", "fullAddress": "Harbour Business Centre, Industrial Estate, Waterford, Co Waterford, Ireland", "buildingName": "Harbour Business Centre", "streetName": "Industrial Estate", "city": "Waterford", "region": "Co Waterford", "country": "Ireland", "isoCode": "IE" } ], "sources": [ { "entityName": "ATLANTIC TRADING LIMITED", "entityType": "Company", "context": "Registered Address", "path": "EnhancedProfile.Addresses[0]" } ] } ] } } ``` ### How geocoded addresses work * Each address in the `addresses` array has an **`identifier`** that matches the `Address.identifier` field in the main Enhanced Profile response * **`variants`** contain parsed/geocoded address representations with structured fields (`streetNumber`, `streetName`, `city`, `postcode`, `region`, `country`, `isoCode`) * **`sources`** trace each address back to its entity (company, individual, or corporate representative) and context (Registered Address, Service Address) * Covers **all** addresses in the profile: company registered address and representative addresses ### About the `extend` parameter The `extend` parameter accepts a comma-separated list of extension types (e.g., `extend=geocoding` or `extend=geocoding,firmographics`). Unrecognised or unauthorised values are silently ignored. Currently, `geocoding` is the first available extension type, providing address geocoding for Ireland. Additional extension types will be added as they become available. ## Filings ### 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** | Detail | Value | | ------------- | -------------------- | | Cost | 5 credits per filing | | Delivery time | Within 15 minutes | | Format | `application/pdf` | The `B`/`C` entity-type indicator is encoded inside the `kyckr_id` and is handled internally — V2 customers don't need to inspect a separate code field. #### Sample response ```json theme={null} { "correlationId": "EXAMPLE-CORRELATION-ID", "cost": { "type": "credit", "value": 0 }, "timeStamp": "2026-04-28T13:01:49.7892419Z", "details": "Success", "continuationKey": "EXAMPLE_CONTINUATION_KEY", "data": [ { "id": "EXAMPLE_BUSINESS_NAME_PROFILE_ID", "cost": { "type": "credit", "value": 5.00 }, "name": "Business Name Profile", "deliveryTimeMinutes": 15, "documentFormat": [ "application/pdf" ] }, { "id": "EXAMPLE_BUSINESS_NAME_REGISTRATION_FORM_ID", "cost": { "type": "credit", "value": 5.00 }, "name": "Business Name Registration Form", "deliveryTimeMinutes": 15, "documentFormat": [ "application/pdf" ] }, { "id": "EXAMPLE_CERTIFICATE_OF_REGISTRATION_ID", "cost": { "type": "credit", "value": 5.00 }, "name": "Certificate of Registration", "deliveryTimeMinutes": 15, "documentFormat": [ "application/pdf" ] } ] } ``` ## Additional resources * [Lite Profile Documentation](/documentation/features/verify-basic-details-v2) * [Enhanced Profile Documentation](/documentation/features/perform-a-kyb-check-v2) * [Search API Documentation](/documentation/features/search-for-a-company-v2)