2025 03 italy update

Documentation Index

Fetch the complete documentation index at: https://developer.kyckr.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

⚠️ Important note on codice fiscale

​

Italy company identifiers

​

Key changes

• Search Response: Modified the codeField to use the REA number (IT_REA_CD)
• Lite Profile: Updated company identifier fields to reflect the REA identification system
• Enhanced Profile: Adjusted identifier structure to maintain consistency with search and lite profile changes
• API Calls: Updated all API endpoints to use the new REA identifier format

​

Technical details

​

Search methods

1. Name Search: Search by company name
2. REA: Search using the REA number (IT_REA_CD)
3. Codice Fiscale: Search using the national tax number (IT_TAX_CD) - may return multiple entity matches

​

Response field changes

​

V1 API

• codeField: Now contains the REA (IT_REA_CD) format
• registrationNumberField: Now contains the REA (IT_REA_CD) format
• registrationAuthorityCodeField: Contains the province code (e.g., “MI”)
• otherIdentifiers: [Future] For Lite and Enhanced only, new array containing standardized secondary identifiers with their type codes

​

Example responses

​

Search response

{
    "companiesField": [{
      "codeField": "12345678901",
      "companyIDField": "123456",
      "nameField": "ACME Trading S.R.L.",
      "registrationAuthorityField": "MILANO",
      "registrationAuthorityCodeField": "MI"
    }]
}

{
    "companiesField": [{
      "codeField": "MI123456",
      "companyIDField": "MI123456",
      "nameField": "ACME Trading S.R.L.",
      "registrationAuthorityField": "MILANO",
      "registrationAuthorityCodeField": "MI",
      "registrationNumberField": "MI123456"
    }]
}

​

Lite Profile

{
  "companyProfileField": {
    "codeField": "12345678901",
    "registrationNumberField": "123456",
    "nameField": "ACME Trading S.R.L.",
    "registrationAuthorityField": "MILANO"
  }
}

{
  "companyProfileField": {
    "codeField": "MI123456",
    "nameField": "ACME Trading S.R.L.",
    "registrationAuthorityField": "MILANO",
    "registrationNumberField": "MI123456",
    "otherIdentifiers": [
      { "type": "IT_TAX_CD", "value": "12345678901" }
    ]
  }
}

​

Enhanced Profile

{
  "companyProfileField": {
    "codeField": "12345678901",
    "registrationNumberField": "MI123456"
  }
}

{
  "companyProfileField": {
    "codeField": "MI123456",
    "registrationNumberField": "MI123456",
    "otherIdentifiers": [
      { "type": "IT_TAX_CD", "value": "12345678901" }
    ]
  }
}

​

API call examples

• Use the codeField value as the company identifier in the URL
• Use the registrationAuthorityCodeField value as the RegAuth query parameter

{
    "companiesField": [{
      "codeField": "MI123456",
      "registrationAuthorityCodeField": "MI",
      "registrationNumberField": "MI123456"
    }]
}

• codeField (“MI123456”) becomes the company identifier in the URL
• registrationAuthorityCodeField (“MI”) becomes the RegAuth parameter

​

Lite Profile

https://rest.kyckr.com/lite/profile/IT/12345678901?RegAuth=MI

https://rest.kyckr.com/lite/profile/IT/MI123456?RegAuth=MI

​

Enhanced Profile

https://rest.kyckr.com/core/company/profile/IT/12345678901?RegAuth=MI

https://rest.kyckr.com/core/company/profile/IT/MI123456?RegAuth=MI

​

Filings Search

https://rest.kyckr.com/core/filing/search/IT/12345678901?RegAuth=MI

https://rest.kyckr.com/core/filing/search/IT/MI123456?RegAuth=MI

​

Migration guide

​

⚠️ Required updates

1. Update search result processing to expect REA identifiers in the codeField
2. Modify systems that store company identifiers
3. Update API calls:
   • Use the REA identifier from the search response’s codeField for ALL profile purchases
   • Include the RegAuth parameter (while optional for Italian companies, this is recommended practice)
   • IMPORTANT: Do not use Codice Fiscale for profile purchases as it may not uniquely identify a company
4. [Future] Update identifier handling:
   • Use the future otherIdentifiers array to access standardized identifiers
   • Use the appropriate type codes (IT_REA_CD, IT_VAT_CD, IT_TAX_CD) to identify different identifier types
   • Note: The REA number is the primary identifier, with fiscal code and VAT number to be provided in the otherIdentifiers array

​

⚠️ Impact assessment

• This change primarily affects systems that:
  • Store Italian company identifiers
  • Make direct API calls without using search response data
  • Rely on Codice Fiscale as primary identifiers
  • Use Codice Fiscale for search - this may return multiple entity matches
  • Use Codice Fiscale for profile purchases (must be updated to use REA numbers)
• Systems already using search response data to make subsequent API calls should require minimal changes

​

Italian province code reference