background image pattern

Developer news

News KYC API: Upcoming changes to our connection to the Norwegian register

KYC API: Upcoming changes to our connection to the Norwegian register

Posted 2025-07-09 | Updated 2025-07-10

Summary

We would like to inform you that we have scheduled the implementation of the following changes to our connection with Brønnøysund Register Centre on KYC API, available with the 23rd of July 2025’s release.

Data additions

We are pleased to share details of the upcoming updates, including the addition of new fields within the refresh dataset. 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 only applicable to KYC API v2.


Refresh dataset
  • extraData.mailingAddress / additionalData.contactInformation.contactAddress
  • extraData.email / additionalData.contactInformation.email
  • extraData.phone / additionalData.contactInformation.phone
  • extradata.numberOfEmployees / additionalData.numberOfEmployees
  • people.officer.birthDate / associatedEntities.officer.dateOfBirth
  • people.officer.isCorporate / associatedEntities.officer.isCorporate
  • people.officer.registrationNumber / associatedEntities.officer.registrationNumber
  • associatedEntities.officer.firstName
  • associatedEntities.officer.middleName
  • associatedEntities.officer.lastName
  • people.shareholder.sharePercentage / associatedEntities.shareholder.sharePercentage
  • associatedEntities.shareholder.firstName
  • associatedEntities.shareholder.middleName
  • associatedEntities.shareholder.lastName


Data enhancements

In addition to the new fields, we are also enhancing the following fields within the refresh dataset. As above, 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 only applicable to KYC API v2.


Refresh dataset
  • extraData.providedStatus / providedStatus
  • people.officer.role / associatedEntities.officer.providedRole
  • people.officer.name / associatedEntities.officer.name
  • people.shareholder.role / associatedEntities.shareholder.providedRole



Data refinement

Resigned officers no longer displayed

To enhance clarity and consistency across our product, we are updating the handling of the people.officer / associatedEntities.officer field. With this change, information about resigned officers will no longer be displayed, ensuring users have access to the most current and relevant data.

Please find the before and after responses per dataset below. Kindly note that the example companies mentioned are fictitious, and the availability of data fields in the mock-up is subject to the specific requirements of legal forms.


Response before for refresh dataset

{
  "datasetId": "2A11489F557BB9F78A65DEA3C361107B",
  "kompanyId": "7D4D8BBA598C6BFB006D5ABED269F0CA",
  "datasetName": "refresh",
  "datasetOptions": null,
  "info": null,
  "status": "COMPLETED",
  "requestTime": "2025-05-15T05:12:22+00:00",
  "responseTime": "2025-05-15T05:12:25+00:00",
  "estimatedDeliverySeconds": 20,
  "content": {
    "kompanyId": "7D4D8BBA598C6BFB006D5ABED269F0CA",
    "countryCode": "NO",
    "countryName": "Norway",
    "state": null,
    "registrationNumber": "980484342",
    "name": "MS MJØLNER something DA",
    "status": "LIVE",
    "providedStatus": null,
    "address": "6240, Abelset, Olaus Abelseth-vegen 19, ØRSKOG, ÅLESUND, Norge",
    "legalForm": "Partrederi",
    "additionalData": {
      "otherIdentifiers": [
        {
          "identifierName": "localNumber",
          "identifierValue": "980484262"
        }
      ],
      "contactInformation": {
        "formattedAddress": {
          "careOf": "Abelset",
          "number": "19",
          "street": "Olaus Abelseth-vegen",
          "zip": "6240",
          "city": "ØRSKOG",
          "region": "ÅLESUND",
          "country": "Norge",
          "countryCode": "NO"
        }
      },
      "legalEvents": {
        "incorporationDate": "1998-12-17",
        "registrationDate": "1999-02-01"
      }
    },
    "associatedEntities": {
      "shareholders": [],
      "officers": [
       {
          "name": "Geir Egil Smenes",
          "role": "officer",
          "providedRole": "Bestyrende reder",
          "dateOfBirth": "1970-08-31"
       },
       {
          "name": "REGNSKAPSHJELP AS",
          "role": "officer",
          "providedRole": "Regnskapsfører",
          "registrationNumber": "123456789"
       },
       {
          "name": "Paul Smith",
          "role": "officer",
          "providedRole": "Bestyrende reder",
          "dateOfBirth": "1970-08-31"
        }
      ]
    },
    "industryActivityCode": {
      "activityCodes": [
        "03.111 Hav- og kystfiske"
      ],
      "activity": "Kystfiske og fjordfiske, og det som naturlig faller inn under det."
    },
    "providerSpecificData": {
      "latestAccounts": {
        "overdue": false
      },
      "signatoryRights": "Deltakerne i fellesskap."
    },
    "sources": [
      {
        "name": "Brønnøysund Register Centre (Brønnøysundregistrene)",
        "info": null,
        "primary": true,
        "fields": [
          "$.status",
          "$.providerSpecificData.signatoryRights",
          "$.additionalData.legalEvents.incorporationDate",
          "$.legalForm",
          "$.industryActivityCode.activityCodes",
          "$.registrationNumber",
          "$.additionalData.otherIdentifiers[0]",
          "$.additionalData.legalEvents.registrationDate",
          "$.industryActivityCode.activity",
          "$.name",
          "$.additionalData.contactInformation.formattedAddress"
        ],
        "lastCheckedTime": "2025-05-15T05:12:23+00:00"
      }
    ],
    "version": "company-v2.0"
  }
}

Response after for refresh dataset

{
  "datasetId": "2A11489F557BB9F78A65DEA3C361107B",
  "kompanyId": "7D4D8BBA598C6BFB006D5ABED269F0CA",
  "datasetName": "refresh",
  "datasetOptions": null,
  "info": null,
  "status": "COMPLETED",
  "requestTime": "2025-05-15T05:12:22+00:00",
  "responseTime": "2025-05-15T05:12:25+00:00",
  "estimatedDeliverySeconds": 20,
  "content": {
    "kompanyId": "7D4D8BBA598C6BFB006D5ABED269F0CA",
    "countryCode": "NO",
    "countryName": "Norway",
    "state": null,
    "registrationNumber": "980484342",
    "name": "MS MJØLNER something DA",
    "status": "LIVE",
    "providedStatus": "under Avvikling",
    "address": "6240, Abelset, Olaus Abelseth-vegen 19, ØRSKOG, ÅLESUND, Norge",
    "legalForm": "Partrederi",
    "additionalData": {
      "otherIdentifiers": [
        {
          "identifierName": "localNumber",
          "identifierValue": "980484262"
        }
      ],
      "contactInformation": {
        "email": "[email protected]",  
        "phone": "+47 123 45 678",
        "formattedAddress": {
          "careOf": "Abelset",
          "number": "19",
          "street": "Olaus Abelseth-vegen",
          "zip": "6240",
          "city": "ØRSKOG",
          "region": "ÅLESUND",
          "country": "Norge",
          "countryCode": "NO"
        }
      },
      "legalEvents": {
        "incorporationDate": "1998-12-17",
        "registrationDate": "1999-02-01"
      }
    },
    "associatedEntities": {
      "shareholders": [
        {
          "name": "Ingunn Solvor Marken",
          "firstName": "Ingunn Solvor",
          "lastName": "Marken",
          "role": "shareholder",
          "providedRole": "Deltaker med delt ansvar",
          "isCorporate": false,
          "dateOfBirth": "1964-05-18",
          "sharePercentage": "50"
       }
      ],
      "officers": [
       {
          "name": "Geir Egil Smenes",
          "firstName": "Geir",
          "middleName": "Egil",
          "lastName": "Smenes",
          "role": "officer",
          "providedRole": "Bestyrende reder",
          "isCorporate": false,
          "dateOfBirth": "1970-08-31"
       },
       {
          "name": "REGNSKAPSHJELP AS",
          "role": "officer",
          "providedRole": "Regnskapsfører",
          "isCorporate": true,
          "registrationNumber": "123456789"
       }
      ]
    },
    "industryActivityCode": {
      "activityCodes": [
        "03.111 Hav- og kystfiske"
      ],
      "activity": "Kystfiske og fjordfiske, og det som naturlig faller inn under det."
    },
    "providerSpecificData": {
      "latestAccounts": {
        "overdue": false
      },
      "signatoryRights": "Deltakerne i fellesskap."
    },
    "sources": [
      {
        "name": "Brønnøysund Register Centre (Brønnøysundregistrene)",
        "info": null,
        "primary": true,
        "fields": [
          "$.status",
          "$.providerSpecificData.signatoryRights",
          "$.additionalData.legalEvents.incorporationDate",
          "$.legalForm",
          "$.industryActivityCode.activityCodes",
          "$.registrationNumber",
          "$.additionalData.otherIdentifiers[0]",
          "$.additionalData.legalEvents.registrationDate",
          "$.industryActivityCode.activity",
          "$.name",
          "$.additionalData.contactInformation.formattedAddress"
        ],
        "lastCheckedTime": "2025-05-15T05:12:23+00:00"
      }
    ],
    "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

Next