Developer news

News KYC API: Upcoming changes within our connection to Finland

KYC API: Upcoming changes within our connection to Finland

Posted 2025-05-14 | Updated 2025-05-16

Summary

We would like to inform you that we have scheduled the implementation of the following changes to our connection with the Finnish Patent and Registration Office (Patentti- ja rekisterihallitus) on KYC API, available with the 27th of May 2025’s release.

Enhanced search

In addition to the existing name search we are excited to introduce the ability to search by number. This feature will be available for all legal types registered in the Finnish business register, except for sole traders and NGOs.

Data improvements

Alongside the new search functionality, the datasets within the areas mentioned below are being improved. The first field applies to KYC API v1, whereas the second field is relevant to KYC API v2. If only one field is presented, it is applicable to both versions, unless indicated otherwise.

Refresh dataset

status
extraData.providedStatus / providedStatus
address
extraData.oldName / additionalData.otherNames.oldNames
extraData.euId / additionalData.otherIdentifiers.euId
extraData.registrationDate / additionalData.legalEvents.registrationDate
extraData.website / additionalData.contactInformation.website
formattedAddress / additionalData.contactInformation.formattedAddress

city
zip
street
number

sicNaceCodes / industryActivityCode.activityCodes

Super dataset

signatoryRights / content.providerSpecificData.signatoryRights
officer.signatureRights / content.associatedEntities.officers.additionalAssociatedEntityData.signatoryRights
extraData.email / additionaldata.contactinformation.email
extraData.shareCapital / additionalData.shares.shareCapital
extraData.shareCurrency / additionalData.shares.shareCurrency
content.providerSpecificData.latestAccounts.lastMadeUpDate (KYC API v2 only)
extraData.registrationDate / providerSpecificData.registrationDate
extraData.phone / additionalData.contactInformation.phone

Data refinement

To improve data accuracy, we have decided to utilize registrationDate as field name instead of incorporationDate for Finland as it more accurately reflects the mapped value. To minimize disruption for clients using KYC API v1, we will continue to display the incorporationDate with the value of registrationDate in KYC API v1. Furthermore, to maintain product integrity, the incorporationDate will be removed from KYC API v2 moving forward.

Response before for refresh dataset


 {
  "datasetId": "3D4F128559F947903A2E6C3D94A959D9",
  "kompanyId": "3692321BC28B6497BE17729F4545BDA6",
  "datasetName": "refresh",
  "datasetOptions": null,
  "info": null,
  "status": "COMPLETED",
  "requestTime": "2025-03-04T14:44:56+00:00",
  "responseTime": "2025-03-04T14:44:58+00:00",
  "estimatedDeliverySeconds": 21,
  "content": {
    "kompanyId": "3692321BC28B6497BE17729F4545BDA6",
    "countryCode": "FI",
    "countryName": "Finland",
    "state": null,
    "registrationNumber": "1463611-4",
    "name": "Fortum Oyj",
    "status": "NOT REPORTED",
    "providedStatus": null,
    "address": "Espoo",
    "legalForm": "Julkinen osakeyhtiö",
    "additionalData": {
      "otherIdentifiers": [
        {
          "identifierName": "lei",
          "identifierValue": "635400IUIZZIUJSAMF76",
          "issuedDate": "2014-02-03",
          "renewalDate": "2026-02-07",
          "leiStatus": "ISSUED"
        },
        {
          "identifierName": "localNumber",
          "identifierValue": "1463611-4"
        }
      ],
      "otherNames": {
        "otherNames": [
          "Fortum Abp"
        ]
      }
    },
    "associatedEntities": {
      "shareholders": [],
      "officers": []
    },
    "industryActivityCode": null,
    "providerSpecificData": {
      "latestAccounts": {
        "overdue": false
      }
    },
    "sources": [
      {
        "name": "Finnish Patent and Registration Office (Patentti- ja rekisterihallitus)",
        "info": null,
        "primary": false,
        "fields": [
          "$.legalForm",
          "$.additionalData.otherNames.otherNames",
          "$.registrationNumber",
          "$.additionalData.otherIdentifiers[1]",
          "$.name",
          "$.address"
        ],
        "lastCheckedTime": "2025-03-04T14:44:56+00:00"
      },
      {
        "name": "Global Legal Entity Identifier Foundation",
        "info": null,
        "primary": false,
        "fields": [
          "$.additionalData.otherIdentifiers[0]"
        ],
        "lastCheckedTime": "2025-03-04T14:44:58+00:00"
      }
    ],

Response after for refresh dataset


{
  "datasetId": "BF455FE08BE1E217C5276534BCB06BF8",
  "kompanyId": "3692321BC28B6497BE17729F4545BDA6",
  "datasetName": "refresh",
  "datasetOptions": null,
  "info": null,
  "status": "COMPLETED",
  "requestTime": "2025-04-16T19:37:10+00:00",
  "responseTime": "2025-04-16T19:37:15+00:00",
  "estimatedDeliverySeconds": 21,
  "content": {
    "kompanyId": "3692321BC28B6497BE17729F4545BDA6",
    "countryCode": "FI",
    "countryName": "Finland",
    "state": null,
    "registrationNumber": "1463611-4",
    "name": "Fortum Oyj",
    "status": "LIVE",
    "providedStatus": "Rekisterissä",
    "address": "Keilalahdentie 2-4, ESPOO, 02150",
    "legalForm": "Julkinen osakeyhtiö",
    "additionalData": {
      "otherIdentifiers": [
        {
          "identifierName": "lei",
          "identifierValue": "635400IUIZZIUJSAMF76",
          "issuedDate": "2014-02-03",
          "renewalDate": "2026-02-07",
          "leiStatus": "ISSUED"
        },
        {
          "identifierName": "localNumber",
          "identifierValue": "1463611-4"
        },
        {
          "identifierName": "euid",
          "identifierValue": "FIFPRO.1463611-4"
        }
      ],
      "otherNames": {
        "otherNames": [
          "IVO-Neste Yhtymä Oyj"
          "IVO-Neste Yhtymä"
          "Fortum Abp"
        ],
        "oldNames": [
          "IVO-Neste Yhtymä Oyj",
          "FFW 1987 LIMITED"
        ]
      }
    },
    "legalEvents": {
        "registrationDate": "2021-12-16"
      },
      "contactInformation": {
        "contactAddress":"560, FORTUM, 02150",
        "website": "www.fortum.fi",
        "formattedAddress": {
          "number": "2-4",
          "street": "Keilalahdentie",
          "zip": "02150",
          "city": "ESPOO"
        },
      },
    "associatedEntities": {
      "shareholders": [],
      "officers": []
    },
    "industryActivityCode": {
      "activityCodes": "70100 - Pääkonttorien toiminta"
    },
    "providerSpecificData": {
      "latestAccounts": {
        "overdue": false
      }
    },
    "sources": [
      {
        "name": "Finnish Patent and Registration Office (Patentti- ja rekisterihallitus)",
        "info": null,
        "primary": false,
        "fields": [
          "$.legalForm",
          "$.additionalData.otherNames.otherNames",
          "$.registrationNumber",
          "$.additionalData.otherIdentifiers[1]",
          "$.name",
          "$.address"
        ],
        "lastCheckedTime": "2025-04-16T19:37:11+00:00"
      },
      {
        "name": "Global Legal Entity Identifier Foundation",
        "info": null,
        "primary": false,
        "fields": [
          "$.additionalData.otherIdentifiers[0]"
        ],
        "lastCheckedTime": "2025-04-16T19:37:15+00:00"
      }
    ],
    "version": "company-v2.0"
  }
}

Response before for super dataset


 {
  "datasetId": "E21EC31799398B8B1951C64C86344B0B",
  "kompanyId": "CC315F735DC38856D864A5F7F0371574",
  "datasetName": "super",
  "datasetOptions": null,
  "info": null,
  "status": "COMPLETED",
  "requestTime": "2025-05-14T16:19:18+00:00",
  "responseTime": "2025-05-14T16:19:34+00:00",
  "estimatedDeliverySeconds": 35,
  "content": {
    "kompanyId": "CC315F735DC38856D864A5F7F0371574",
    "countryCode": "FI",
    "countryName": "Finland",
    "state": null,
    "registrationNumber": "1830420-5",
    "name": "Asunto Oy Painiitynportti Espoo",
    "status": "NOT REPORTED",
    "providedStatus": "Registered",
    "address": "Puustellinpolku 25, 00410, Helsinki, Finland",
    "legalForm": "Asunto-osakeyhtiö",
    "additionalData": {
      "otherIdentifiers": [
        {
          "identifierName": "localNumber",
          "identifierValue": "1830420-5"
        },
        {
          "identifierName": "vat",
          "identifierValue": "FI18304205"
        }
      ],
      "legalEvents": {
        "incorporationDate": "2003-05-14"
      }
    },
    "associatedEntities": {
      "shareholders": [],
      "officers": [
        {
          "name": "Vesanen Jaakko Kalevi",
          "role": "officer",
          "providedRole": "Chairperson of the Board of Directors",
          "isCorporate": false,
          "dateOfBirth": "1964-05-18"
        },
        {
          "name": "Ekström Kai Markus Rainer",
          "role": "officer",
          "providedRole": "Member of the Board of Directors",
          "isCorporate": false,
          "dateOfBirth": "1969-11-16"
        },
        {
          "name": "Halonen Pauli Petteri",
          "role": "officer",
          "providedRole": "Member of the Board of Directors",
          "isCorporate": false,
          "dateOfBirth": "1967-01-05"
        },
        {
          "name": "Mikkanen Timo Ensio",
          "role": "officer",
          "providedRole": "House Manager",
          "isCorporate": false,
          "dateOfBirth": "1961-10-18"
        },
        {
          "name": "Auditus Tilintarkastus Oy",
          "role": "officer",
          "providedRole": "Auditor",
          "isCorporate": true,
          "registrationNumber": "0727888-1"
        },
        {
          "name": "Saarelainen Pirjo Marjatta",
          "role": "officer",
          "providedRole": "Auditor with principal responsibility",
          "isCorporate": false,
          "dateOfBirth": "1956-03-29"
        }
      ],
      "ultimateBeneficialOwners": []
    },
    "industryActivityCode": {
      "activity": "Yhtiön toimialana on vuokrasopimuksen perusteella hallita Espoon kaupungin 50. kaupunginosan korttelissa 50201 sijaitsevaa tonttia nro 1 ja omistaa ja hallita tontille rakennettavia rakennuksia. Yhtiön omistamassa asuinrakennuksessa on huoneistojen y, hteenlasketusta pinta-alasta enin osa varattu osakkeenomistajille asuinhuoneistoiksi."
    },
    "providerSpecificData": {
      "latestAccounts": {
        "overdue": false
      }
    },
    "sources": [
      {
        "name": "Finnish Patent and Registration Office (Patentti- ja rekisterihallitus)",
        "info": null,
        "primary": false,
        "fields": [
          "$.status",
          "$.additionalData.legalEvents.incorporationDate",
          "$.legalForm",
          "$.additionalData.otherIdentifiers[1]",
          "$.registrationNumber",
          "$.additionalData.otherIdentifiers[0]",
          "$.providedStatus",
          "$.industryActivityCode.activity",
          "$.name",
          "$.associatedEntities.officers",
          "$.address"
        ],
        "lastCheckedTime": "1746182829"
      }
    ],
    "version": "company-v2.0"
  }
}

Response after for super dataset


{
  "datasetId": "E21EC31799398B8B1951C64C86344B0B",
  "kompanyId": "CC315F735DC38856D864A5F7F0371574",
  "datasetName": "super",
  "datasetOptions": null,
  "info": null,
  "status": "COMPLETED",
  "requestTime": "2025-05-14T16:19:18+00:00",
  "responseTime": "2025-05-14T16:19:34+00:00",
  "estimatedDeliverySeconds": 35,
  "content": {
    "kompanyId": "CC315F735DC38856D864A5F7F0371574",
    "countryCode": "FI",
    "countryName": "Finland",
    "state": null,
    "registrationNumber": "1830420-5",
    "name": "Asunto Oy Painiitynportti Espoo",
    "status": "LIVE",
    "providedStatus": "Registered",
    "address": "Puustellinpolku 25, 00410, Helsinki, Finland",
    "legalForm": "Asunto-osakeyhtiö",
    "additionalData": {
      "otherIdentifiers": [
        {
          "identifierName": "localNumber",
          "identifierValue": "1830420-5"
        },
        {
          "identifierName": "vat",
          "identifierValue": "FI18304205"
        }
      ],
      "contactInformation": {
        "phone":"044 205 7935",
        "email": "[email protected]",
      },
      "shares": {
        "shareCapitals": "9108.0",
        "shareCurrency": "EUR"
      },

      "legalEvents": {
        "registrationDate": "2003-05-14"
      }
    },
    "associatedEntities": {
      "shareholders": [],
      "officers": [
        {
          "name": "Vesanen Jaakko Kalevi",
          "role": "officer",
          "providedRole": "Chairperson of the Board of Directors",
          "isCorporate": false,
          "dateOfBirth": "1964-05-18"
        },
        {
          "name": "Ekström Kai Markus Rainer",
          "role": "officer",
          "providedRole": "Member of the Board of Directors",
          "isCorporate": false,
          "dateOfBirth": "1969-11-16"
          "additionalAssociatedEntityData":[
            "signatoryRights": "Joint Authorised"
          ]
        },
        {
          "name": "Halonen Pauli Petteri",
          "role": "officer",
          "providedRole": "Member of the Board of Directors",
          "isCorporate": false,
          "dateOfBirth": "1967-01-05"
        },
        {
          "name": "Mikkanen Timo Ensio",
          "role": "officer",
          "providedRole": "House Manager",
          "isCorporate": false,
          "dateOfBirth": "1961-10-18"
        },
        {
          "name": "Auditus Tilintarkastus Oy",
          "role": "officer",
          "providedRole": "Auditor",
          "isCorporate": true,
          "registrationNumber": "0727888-1"
        },
        {
          "name": "Saarelainen Pirjo Marjatta",
          "role": "officer",
          "providedRole": "Auditor with principal responsibility",
          "isCorporate": false,
          "dateOfBirth": "1956-03-29"
        }
      ],
      "ultimateBeneficialOwners": []
    },
    "industryActivityCode": {
      "activity": "Yhtiön toimialana on vuokrasopimuksen perusteella hallita Espoon kaupungin 50. kaupunginosan korttelissa 50201 sijaitsevaa tonttia nro 1 ja omistaa ja hallita tontille rakennettavia rakennuksia. Yhtiön omistamassa asuinrakennuksessa on huoneistojen y, hteenlasketusta pinta-alasta enin osa varattu osakkeenomistajille asuinhuoneistoiksi."
    },
    "providerSpecificData": {
      "signatoryRights": "Under the law, the Board of Directors represents the company By the Chair of the Board and the House Manager, each on his/her own, and by any two Board members jointly",
      "latestAccounts": {
        "lastMadeUpDate": "2008-06-06",
        "overdue": false
      }
    },
    "sources": [
      {
        "name": "Finnish Patent and Registration Office (Patentti- ja rekisterihallitus)",
        "info": null,
        "primary": false,
        "fields": [
          "$.status",
          "$.additionalData.legalEvents.incorporationDate",
          "$.legalForm",
          "$.additionalData.otherIdentifiers[1]",
          "$.registrationNumber",
          "$.additionalData.otherIdentifiers[0]",
          "$.providedStatus",
          "$.industryActivityCode.activity",
          "$.name",
          "$.associatedEntities.officers",
          "$.address"
        ],
        "lastCheckedTime": "1746182829"
      }
    ],
    "version": "company-v2.0"
  }
}

If you would like to provide us with feedback or you have a question related to this, don’t hesitate to contact us here: support team