company-v2Updated: 2026-04-10

Ireland Company Data – Enhanced Profile Refresh, Business Name Support, and Address Geocoding

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

Additional resources