Ireland Company Data – Search, Lite Profile, Enhanced Profile, and Business Name 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:

{
  "companiesField": [
    {
      "codeField": "234567",
      "nameField": "ATLANTIC TRADING LIMITED"
    }
  ]
}

After:

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

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

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

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

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

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

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

Documentation Index

​Overview

​Key points

​Search results

​codeField format change

​Lite profile changes

​Response structure changes

​Key changes

​Address parsing

​Date fields

​Legal form and status

​New fields

​Activity data

​Enhanced profile changes

​Response structure changes

​showDirectorships query parameter

​How it works

​Key changes

​Activity data

​Financial data

​Directors

​Shareholders

​Business Name support

​How it works

​Key characteristics of Business Name profiles

​Filings

​Companies

​Date format change

​Deprecated fields

​Business Names

​Additional resources

Overview

Key points

Search results

codeField format change

Lite profile changes

Response structure changes

Key changes

Address parsing

Date fields

Legal form and status

New fields

Activity data

Enhanced profile changes

Response structure changes

showDirectorships query parameter

How it works

Key changes

Activity data

Financial data

Directors

Shareholders

Business Name support

How it works

Key characteristics of Business Name profiles

Filings

Companies

Date format change

Deprecated fields

Business Names

Additional resources