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, otherIdentifiers array, aliases with structured objects, cleaner dates and legal forms
  • Enhanced Profile: New fields — activities, activityDeclarations, lastAnnualAccountDate, totalCapital, corporate representatives (Ultimate Parent, Immediate Parent)
  • 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

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

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 SIC code classification {"code": "6201", "classificationScheme": "SIC", "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}

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

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": "HARBOUR BUSINESS CENTRE",
      "country": "IRELAND",
      "fullAddress": "HARBOUR BUSINESS CENTRE, INDUSTRIAL ESTATE, CORK ROAD WATERFORD, CO WATERFORD, IRELAND, IRELAND",
      "identifier": "xK7mNpQr2wYs5tB8vHjL3fRcDgE9aW4uZiO6nM1kXbA",
      "streetName": "INDUSTRIAL ESTATE"
    }
  ],
  "capital": [
    {
      "classCode": "ORDINARY",
      "currency": "EUR",
      "quantity": 3786684.0,
      "shareholdings": [
        {
          "count": 3786684,
          "percentage": "100.00",
          "shareholders": {
            "corporations": [
              {"name": "SOUTHERN VENTURES PTY LIMITED", "type": "Corporation"}
            ]
          },
          "totalNominalValue": 0.5
        }
      ],
      "type": "ORDINARY"
    }
  ],
  "companyName": "ATLANTIC TRADING LIMITED",
  "identifiers": {"primaryRegistrationNumber": "234567"},
  "legalForm": {"original": "1153 - LTD - Private Company Limited by Shares"},
  "registrationAuthority": "Companies Registration Office Ireland",
  "registrationDate": {"normalized": "2010-06-15", "original": "2010-06-15T00:00:00Z"},
  "representatives": {
    "individuals": [
      {
        "birthdate": {"normalized": "1965-03-15", "original": "15/03/1965"},
        "directorships": [
          {"companyName": "ATLANTIC TRADING LIMITED", "companyNumber": "234567", "role": "Director", "startDate": {"normalized": "2024-03-15", "original": "15/03/2024"}}
        ],
        "isActive": true,
        "name": "John Murphy",
        "placeOfResidence": {
          "buildingName": "25 George Street",
          "city": "Sydney, Australia",
          "fullAddress": "25 George Street, Parramatta, Sydney, Australia",
          "identifier": "pQ7rS8tU9vW0xY1zA2bC3dE4fG5hI6jK7lM8nO9pQ0rS",
          "streetName": "Parramatta"
        },
        "role": {"original": "Director"},
        "type": "Person"
      }
    ]
  },
  "status": {"normalized": "Active", "original": "Normal "}
}

After (registration 234567 — ATLANTIC TRADING LIMITED):

{
  "activities": [
    {"classificationScheme": "SIC", "code": "6201", "type": "Primary"}
  ],
  "activityDeclarations": [
    {"declaration": "Development and distribution of software solutions.", "declarationDescription": "Principal Activity", "language": "en"}
  ],
  "addresses": [
    {
      "buildingName": "HARBOUR BUSINESS CENTRE",
      "city": "CORK ROAD WATERFORD",
      "country": "Ireland",
      "fullAddress": "HARBOUR BUSINESS CENTRE, INDUSTRIAL ESTATE, CORK ROAD WATERFORD, CO WATERFORD IRELAND",
      "identifier": "IE-aB3cD4eF5gH6iJ7kL8mN9oP0qR1sT2uV3wX4yZ5aB6",
      "isoCode": "IE",
      "municipality": "CO WATERFORD, IRELAND",
      "rawAddressLines": ["HARBOUR BUSINESS CENTRE", "INDUSTRIAL ESTATE", "CORK ROAD WATERFORD", "CO WATERFORD, IRELAND"],
      "streetName": "INDUSTRIAL ESTATE",
      "type": "Registered Address"
    }
  ],
  "capital": [
    {
      "classCode": "ORDINARY",
      "classDescription": "ORDINARY",
      "currency": "EUR",
      "description": "ORDINARY",
      "quantity": 3786684,
      "shareholdings": [
        {
          "count": 3786684,
          "percentage": "100.00",
          "shareholders": {
            "corporations": [
              {"name": "SOUTHERN VENTURES PTY LIMITED", "type": "Corporation"}
            ]
          },
          "totalNominalValue": 1893342
        }
      ],
      "totalNominalValue": 1893342,
      "type": "ORDINARY",
      "unitNominalValue": 0.5,
      "votingRights": "Undisclosed"
    }
  ],
  "companyName": "ATLANTIC TRADING LIMITED",
  "identifiers": {"primaryRegistrationNumber": "234567"},
  "lastAnnualAccountDate": {"normalized": "2024-09-30", "original": "2024-09-30"},
  "legalForm": {"original": "LTD - Private Company Limited by Shares"},
  "registrationAuthority": "Companies Registration Office Ireland",
  "registrationDate": {"normalized": "2010-06-15", "original": "2010-06-15"},
  "representatives": {
    "corporations": [
      {
        "isActive": true,
        "name": "PACIFIC HOLDINGS PTY LIMITED",
        "registeredAddress": {
          "country": "Australia",
          "fullAddress": "88 PITT STREET, SYDNEY, NSW, 2000",
          "identifier": "AU-rS3tU4vW5xY6zA7bC8dE9fG0hI1jK2lM3nO4pQ5rS6",
          "isoCode": "AU"
        },
        "registrationNumber": "987654321",
        "role": {"original": "Ultimate Parent"},
        "type": "Corporation"
      }
    ],
    "individuals": [
      {
        "address": {
          "fullAddress": "12 Meadow Lane, Tramore, Waterford Ireland",
          "identifier": "kL7mN8oP9qR0sT1uV2wX3yZ4aB5cD6eF7gH8iJ9kL0",
          "municipality": "Waterford  Ireland",
          "postcode": "X91 AB12",
          "streetName": "12 Meadow Lane, Tramore",
          "type": "Service Address"
        },
        "birthdate": {"normalized": "1980-11", "original": "1980-11"},
        "idNumber": "501234567",
        "isActive": true,
        "name": "Sarah O'Brien",
        "role": {"original": "Director"},
        "startDate": {"normalized": "2024-08-01", "original": "2024-08-01"},
        "type": "Person"
      }
    ]
  },
  "status": {"normalized": "Active", "original": "Normal"},
  "totalCapital": {"currency": "EUR", "quantity": 3786684, "totalValue": 1893342}
}

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. Un-prefixed registration numbers are assumed to be a company number, not a business name number.

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.

Additional resources