company-v1Updated: 2026-04-10

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

Additional resources