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

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

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

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.

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

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

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

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

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:

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

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

Documentation Index

​Overview

​Key points

​Lite profile changes

​Address structure

​Other improvements

​Activity data

​Sample response

​Enhanced profile changes

​New fields

​Activity data

​Enhanced existing fields

​Addresses

​Capital

​Representatives

​showDirectorships query parameter

​How it works

​Data quality improvements

​Before/after comparison

​Business Name support

​How it works

​Example: Business Name profile (registration 345678)

​Geocoding — extend query parameter (Beta)

​⚠️ Controlled access feature

​Request

​Response structure

​How geocoded addresses work

​About the extend parameter

​Filings

​Business Names

​Sample response

​Additional resources

Overview

Key points

Lite profile changes

Address structure

Other improvements

Activity data

Sample response

Enhanced profile changes

New fields

Activity data

Enhanced existing fields

Addresses

Capital

Representatives

showDirectorships query parameter

How it works

Data quality improvements

Before/after comparison

Business Name support

How it works

Example: Business Name profile (registration 345678)

Geocoding — `extend` query parameter (Beta)

⚠️ Controlled access feature

Request

Response structure

How geocoded addresses work

About the `extend` parameter

Filings

Business Names

Sample response

Additional resources