Skip to main content

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

As part of Kyckr’s migration from the EBR (European Business Registry Network) to a direct connection with PRH (Finnish Patent and Registration Office), we’ve updated Search, Lite Profile, Enhanced Profile, and Filing responses for Finland (ISO code FI). All four products remain available and have been improved with richer data, better address parsing, and broader coverage. A key addition is company number search, which was not previously available — customers can now search by both company name and registration number.

​
Search results

Search responses for Finland have been improved with richer data following the direct registry connection. Previously, Finland search only supported name-based searches. After migration, both name search and number search are supported.

​
Response structure changes

Before (EBR — name search): 
{
  "correlationId": "019d1848-1e93-719d-8d33-761df7ba02e1",
  "cost": {
    "type": "credit",
    "value": 0
  },
  "timeStamp": "2026-03-23T01:21:46.7311655Z",
  "details": "Success",
  "data": [
    {
      "id": "FI|MDEwMDAyNC04fEZJUEFUUkVL",
      "companyName": "Asunto Oy Tammilehto",
      "companyNumber": "0100024-8",
      "address": "Artjärvi",
      "registrationAuthority": "Finnish Patent and Registration Office"
    }
  ]
}
After (PRH — number search): 
{
  "correlationId": "019d184a-5c5a-719d-bf15-624cd6a1dbd1",
  "cost": {
    "type": "credit",
    "value": 0
  },
  "timeStamp": "2026-03-23T01:23:40.0032039Z",
  "details": "Success",
  "data": [
    {
      "id": "FI|MDEwMDAwMi05",
      "companyName": "Artjärven Metalli Oy",
      "companyNumber": "0100002-9",
      "address": "PL 212, VIITASAARI, Finland, 44501",
      "status": "Dissolved",
      "type": "Limited company",
      "startDate": "1976-04-23",
      "registrationAuthority": "Finnish Patent and Registration Office"
    }
  ]
}

​
Key changes

  • address: Now includes full structured address with street, city, country, and postcode (previously city only)
  • status: New field providing the company’s registration status (e.g., “Dissolved”, “In the register”)
  • type: New field providing the company’s legal form (e.g., “Limited company”, “Limited partnership”, “Housing company”)
  • startDate: New field providing the company’s registration date in ISO format

​
Lite profile changes

The response structure has been updated due to the new provider, with improved address parsing, additional fields, and Finnish-language activity descriptions.

​
Response structure changes

Before (EBR): 
{
  "correlationId": "019d1848-a79a-719d-b112-bba73b7ec6cd",
  "cost": {
    "type": "lite",
    "value": 1
  },
  "data": {
    "activity": [
      {
        "description": "Operating of own or leased dwellings and residential real estate",
        "type": "Primary"
      }
    ],
    "address": {
      "buildingName": "2 Salmelantie ARTJÄRVI 16200",
      "fullAddress": "2 Salmelantie ARTJÄRVI 16200"
    },
    "companyName": "Asunto Oy Tammilehto",
    "companyNumber": "0100024-8",
    "foundationDate": {
      "normalized": "1978-03-15",
      "original": "1978-03-15"
    },
    "legalForm": {
      "original": "Housing corporation"
    },
    "legalStatus": {
      "normalized": "Active",
      "original": "Active"
    },
    "registrationAuthority": "Finnish Trade Register",
    "registrationDate": {
      "normalized": "1978-03-15",
      "original": "1978-03-15"
    }
  },
  "details": "Success",
  "timeStamp": "2026-03-23T01:21:48.9784822Z"
}
After (PRH): 
{
  "correlationId": "019d1848-bd6e-719d-896e-b39c35616ac5",
  "cost": {
    "type": "lite",
    "value": 1
  },
  "data": {
    "activity": [
      {
        "description": "Yhtiön toimialana on omistaa ja hallita Tammilehto-nimistä tilaa rek.nro 1:73 Artjärven kunnan Kinttulan kylässä sekä sille rakennettua kerrostaloa, jonka huoneistojen yhteenlasketusta lattiapinta-alasta enin osa varattu osakkeenomistajille asuinhuoneistoiksi.",
        "type": "Primary"
      }
    ],
    "address": {
      "city": "Artjärvi",
      "country": "Finland",
      "fullAddress": "Salmelantie 2, Artjärvi, Finland, 16200",
      "isoCode": "FI",
      "postcode": "16200",
      "rawAddressLines": [
        "Salmelantie 2",
        "Artjärvi",
        "Finland",
        "16200"
      ],
      "streetName": "Salmelantie 2"
    },
    "companyName": "Asunto Oy Tammilehto",
    "companyNumber": "0100024-8",
    "foundationDate": {
      "normalized": "1974-12-05",
      "original": "1974-12-05"
    },
    "legalForm": {
      "original": "Housing company"
    },
    "legalStatus": {
      "normalized": "Active",
      "original": "In the register"
    },
    "registrationAuthority": "Finnish Patent and Registration Office",
    "registrationDate": {
      "normalized": "1974-12-05",
      "original": "1974-12-05"
    }
  },
  "details": "Success",
  "timeStamp": "2026-03-23T01:21:54.5843962Z"
}

​
Field mapping changes

​
Address structure

The address structure has been enhanced with better parsing and structured fields: Key improvements:
  • address is now fully populated with structured fields (previously only buildingName and fullAddress)
  • city, country, postcode, and isoCode fields are now included
  • rawAddressLines array provides the original address components
  • streetName now contains just the street address
  • fullAddress now provides a properly formatted complete address string
  • buildingName has been removed (previously contained the entire address string)

​
Date fields

Key changes:
  • foundationDate and registrationDate values now reflect PRH registry data
Key changes:
  • legalForm.original values now reflect PRH registry terminology (e.g., “Housing company” instead of “Housing corporation”)
  • legalStatus.original now provides the registry status (e.g., “In the register”) with normalized continuing to provide the standardized value (e.g., “Active”)
  • registrationAuthority now reads “Finnish Patent and Registration Office” (previously “Finnish Trade Register”)

​
Enhanced profile changes

The response structure has been updated due to the new provider, with improved activity data, consolidated address structure, updated capital format, and changed representative role terminology.

​
Response structure changes

Before (EBR): 
{
  "data": {
    "orderId": 5421445,
    "correlationId": "019d0d94-074c-719d-85cd-ff65cf5166f6",
    "timeStamp": "2026-03-20T23:28:22.1230872Z",
    "details": "Success",
    "data": {
      "activities": [
        {
          "code": "6820",
          "description": "Renting and operating of own or leased real estate",
          "type": "Primary"
        }
      ],
      "addresses": [
        {
          "type": "Visiting Address",
          "fullAddress": "Salmelantie 2, Artjärvi, 16200, Finland",
          "buildingName": "Salmelantie 2",
          "city": "Artjärvi",
          "postcode": "16200",
          "country": "Finland"
        },
        {
          "type": "Postal Address",
          "fullAddress": "Salmelantie 2, Artjärvi, 16200, Finland",
          "buildingName": "Salmelantie 2",
          "city": "Artjärvi",
          "postcode": "16200",
          "country": "Finland"
        },
        {
          "type": "Unspecified"
        }
      ],
      "capital": [
        {
          "description": "Shared capital",
          "classDescription": "Shared capital",
          "totalNominalValue": 66617.0,
          "currency": "Euro"
        }
      ],
      "representatives": {
        "individuals": [
          {
            "role": {
              "original": "Chairperson of the Board of Directors"
            },
            "isActive": true,
            "birthdate": {
              "original": "1970-11-22",
              "normalized": "1970-11-22"
            },
            "placeOfResidence": {},
            "type": "Person",
            "name": "Mika Pitkänen"
          },
          {
            "role": {
              "original": "Member of the Board of Directors"
            },
            "isActive": true,
            "birthdate": {
              "original": "1950-06-13",
              "normalized": "1950-06-13"
            },
            "placeOfResidence": {},
            "type": "Person",
            "name": "Mikael Toivonen"
          }
        ]
      },
      "identifiers": {
        "primaryRegistrationNumber": "0100024-8",
        "taxNumber": "FI01000248"
      },
      "companyName": "Asunto Oy Tammilehto",
      "aliases": [
        {}
      ],
      "registrationAuthority": "Finnish Patent and Registration Office",
      "registrationDate": {
        "original": "1974-12-05",
        "normalized": "1974-12-05"
      },
      "status": {
        "original": "Registered",
        "normalized": "Active"
      },
      "legalForm": {
        "original": "Asunto-osakeyhtiö"
      },
      "links": {
        "document": "/orders/5421445/download",
        "data": "/orders/5421445/download?format=json"
      }
    }
  }
}
After (PRH): 
{
  "data": {
    "orderId": 5421446,
    "correlationId": "019d0d94-28d4-719d-bd68-f6adfa4a4898",
    "timeStamp": "2026-03-20T23:28:28.0358307Z",
    "details": "Success",
    "data": {
      "activities": [
        {
          "description": "Yhtiön toimialana on omistaa ja hallita Tammilehto-nimistä tilaa rek.nro 1:73 Artjärven kunnan Kinttulan kylässä sekä sille rakennettua kerrostaloa, jonka huoneistojen yhteenlasketusta lattiapinta-alasta enin osa varattu osakkeenomistajille asuinhuoneistoiksi.",
          "type": "Primary"
        }
      ],
      "addresses": [
        {
          "fullAddress": "Salmelantie 2, Artjärvi, Finland, 16200",
          "rawAddressLines": [
            "Salmelantie 2",
            "Artjärvi",
            "Finland",
            "16200"
          ],
          "streetName": "Salmelantie 2",
          "city": "Artjärvi",
          "postcode": "16200",
          "country": "Finland",
          "isoCode": "FI"
        }
      ],
      "totalCapital": {
        "totalValue": 66617.56,
        "quantity": 4890,
        "currency": "EUR"
      },
      "representatives": {
        "individuals": [
          {
            "role": {
              "original": "Chairperson"
            },
            "isActive": false,
            "birthdate": {
              "original": "1970-11-22",
              "normalized": "1970-11-22"
            },
            "type": "Person",
            "name": "Mika Pitkänen"
          },
          {
            "role": {
              "original": "Ordinary member"
            },
            "isActive": true,
            "birthdate": {
              "original": "1950-06-13",
              "normalized": "1950-06-13"
            },
            "type": "Person",
            "name": "Mikael Toivonen"
          }
        ]
      },
      "identifiers": {
        "primaryRegistrationNumber": "0100024-8"
      },
      "companyName": "Asunto Oy Tammilehto",
      "registrationAuthority": "Finnish Patent and Registration Office",
      "foundationDate": {
        "original": "1974-12-05",
        "normalized": "1974-12-05"
      },
      "registrationDate": {
        "original": "1974-12-05",
        "normalized": "1974-12-05"
      },
      "status": {
        "original": "In the register",
        "normalized": "Active"
      },
      "legalForm": {
        "original": "Housing company"
      },
      "links": {
        "document": "/orders/5421446/download",
        "data": "/orders/5421446/download?format=json"
      }
    }
  }
}

​
Field mapping changes

​
Address structure

The address structure has been consolidated and enhanced: Key improvements:
  • Multiple address types (Visiting Address, Postal Address, Unspecified) are consolidated into a single structured address
  • rawAddressLines array now provides the original address components
  • streetName now contains the street address (previously buildingName was used)
  • isoCode field is now included (e.g., “FI”)
  • buildingName and type have been removed
  • fullAddress format slightly changed (country and postcode order)

​
Capital information

Key changes:
  • capital was only populated with issued capital which has been replaced by totalCapital object
  • New structure uses totalValue, quantity, and currency (ISO code “EUR”) instead of description, classDescription, totalNominalValue, and currency (full name “Euro”)

​
Representatives

Key changes:
  • Representative role titles are now shortened (e.g., “Chairperson of the Board of Directors” → “Chairperson”, “Member of the Board of Directors” → “Ordinary member”)
  • isActive may now reflect current registry status more accurately

​
Identifiers

Key changes:
  • primaryRegistrationNumber continues to be available
  • aliases with empty objects has been removed

​
Additional fields

Key improvements:
  • foundationDate is now included with original and normalized values
Key changes:
  • legalForm.original now uses English values (e.g., “Housing company”) instead of Finnish (e.g., “Asunto-osakeyhtiö”)
  • status.original now reflects PRH registry status values (e.g., “In the register”) instead of EBR values (e.g., “Registered”); normalized continues to provide “Active”

​
Filing search changes

The filing search response has been updated following the migration to the direct PRH connection. The available document types have changed, with EBR-specific products removed and new PRH document types added. The specific documents available vary by company type.

​
Response structure changes

Before (EBR): 
{
  "correlationId": "019d1a04-c43e-719d-91a8-9041d4005036",
  "cost": {
    "type": "credit",
    "value": 0
  },
  "data": [
    {
      "deliveryTimeMinutes": 0,
      "documentFormat": [
        "application/pdf"
      ],
      "id": "fEVCUk9OX1JVSlNYME52YlhCaGJubFFjbTltYVd4bFh6RT1f...",
      "name": "Company Profile"
    },
    {
      "deliveryTimeMinutes": 0,
      "documentFormat": [
        "application/pdf"
      ],
      "id": "fEVCUk9OX1JVSlNYME52YlhCaGJubFBabVpwWTJsaGJITmZNUT09X...",
      "name": "Company Officials"
    },
    {
      "deliveryTimeMinutes": 5,
      "documentDate": "2026-03-23",
      "documentFormat": [
        "application/pdf"
      ],
      "id": "fEVCUk9GRl9SVlJTX1JrbE9YMFZVVWc9PV9TMkYxY0hCaGNtVnJhWE4w...",
      "name": "Kaupparekisteriote (Extract from Trade Register)"
    },
    {
      "deliveryTimeMinutes": 5,
      "documentDate": "1987-06-30",
      "documentFormat": [
        "application/pdf"
      ],
      "id": "fEVCUk9GRl9UVUU9X1JrbE9YMDFCX1dXaDBaV2x6dzdaenc2VERwRzV1dz...",
      "name": "Yhteisösäännöt (Memorandum and Articles of Association)"
    },
    {
      "deliveryTimeMinutes": 5,
      "documentDate": "2024-12-31",
      "documentFormat": [
        "application/zip"
      ],
      "id": "fEVCUk9GRl9RVUU9X1JrbE9YMEZCX1ZHbHNhVzV3dzZURHBIVER0bk1n...",
      "name": "Tilinpäätös (Annual Accounts)"
    }
  ],
  "details": "Success",
  "timeStamp": "2026-03-23T09:27:07.0309797Z"
}
After (PRH): 
{
  "correlationId": "019d1a05-a898-719d-bc2f-fc2013622d03",
  "cost": {
    "type": "credit",
    "value": 0
  },
  "data": [
    {
      "category": "Filing",
      "deliveryTimeMinutes": 5,
      "documentFormat": [
        "application/pdf"
      ],
      "id": "UkVHSFVCT0ZGfDAxMDEyMzktNnxGSV9QUkhfQ1J8MTA3fENvb3BlcmF0aXZlIFJ1bGVz",
      "name": "Cooperative Rules"
    },
    {
      "category": "Filing",
      "deliveryTimeMinutes": 5,
      "documentFormat": [
        "application/pdf"
      ],
      "id": "UkVHSFVCT0ZGfDAxMDEyMzktNnxGSV9QUkhfVFJFfDEwN3xUcmFkZSBSZWdpc3RlciBFeHRyYWN0IC0gRmlubmlzaA==",
      "name": "Trade Register Extract - Finnish"
    }
  ],
  "details": "Success",
  "timeStamp": "2026-03-23T09:27:51.8168413Z"
}

​
Key changes

​
Removed products

The following EBR-specific products are no longer available:
  • Company Profile — EBR-sourced company profile PDF
  • Company Officials — EBR-sourced company officials PDF

​
New products

The specific documents available depend on company type. Examples of PRH document types now available:
ProductFormat
Cooperative RulesPDF
Trade Register Extract - FinnishPDF

​
Additional resources