Developer news
KYC API: Upcoming changes to our connection to the Malaysian register
Summary
Data availability
To further improve the stability and efficiency of our service, we will be consolidating the super dataset with the refresh dataset. Moving forward, only the refresh dataset will be accessible for your use. This adjustment, made in response to client feedback and improved stability, ensures that all existing data fields remain accessible with no changes to mapped data. Additionally, by consolidating calls, we can reduce operational costs, while maintaining our commitment to providing Malaysian data at no additional charge.
Additional entities
We are pleased to announce the inclusion of entities classified as Limited Liability Partnerships (LLPs) within our integration with the Malaysian registry. For these entities, both the refresh dataset and register report will be available via KYC API v1 and KYC API v2.
We are pleased to share details of the update, 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.
Refresh dataset
New fields
- extraData.registrationDate / additionalData.legalEvents.registrationDate
 
Merged fields
- people.shareholder.name / associatedEntities.shareholder.name
 - people.shareholder.role / associatedEntities.shareholder.role
 - people.shareholder.isCorporate / associatedEntities.shareholder.isCorporate
 - people.shareholder.shareNumber / associatedEntities.shareholder.shareNumber
 - extraData.shareCurrency / additionalData.shares.shareCurrency
 - extraData.capital / additionalData.capitalAmount
 
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": "480DDF5F311A10BA576AB9858E093CF1",
  "kompanyId": "3452467203442351F826783329F504D0",
  "datasetName": "refresh",
  "datasetOptions": null,
  "info": null,
  "status": "COMPLETED",
  "requestTime": "2025-10-21T06:52:42+00:00",
  "responseTime": "2025-10-21T06:52:46+00:00",
  "estimatedDeliverySeconds": 19,
  "content": {
    "kompanyId": "3452467203442351F826783329F504D0",
    "countryCode": "MY",
    "countryName": "Malaysia",
    "state": null,
    "registrationNumber": "19740***2911",
    "name": "PETROLIAM NASIONAL ***",
    "status": "LIVE",
    "providedStatus": "EXISTING",
    "address": "TOWER 1,PETRONAS TWIN TOWER, K.LUMPUR CITY CENTRE K.LUMPUR, 50088, Wilayah Persekutuan, KUALA LUMPUR",
    "legalForm": "PUBLIC LIMITED LIMITED BY SHARES",
    "additionalData": {
      "otherIdentifiers": [
        {
          "identifierName": "lei",
          "identifierValue": "5493003RZQYJM7QGNE15",
          "issuedDate": "2018-04-06T15:31:00Z",
          "renewalDate": "2026-03-13T00:00:00Z",
          "leiStatus": "ISSUED"
        },
        {
          "identifierName": "oldNumber",
          "identifierValue": "2**76"
        },
        {
          "identifierName": "localNumber",
          "identifierValue": "19740***2911"
        }
      ],
      "contactInformation": {
        "contactAddress": "TOWER 1, PETRONAS TWIN TOWERS KUALA LUMPUR CITY CENTRE, 50088, Wilayah Persekutuan, KUALA LUMPUR",
        "formattedAddress": {
          "addressLine1": "TOWER 1,PETRONAS TWIN TOWER",
          "addressLine2": "K.LUMPUR CITY CENTRE K.LUMPUR",
          "zip": "50088",
          "city": "KUALA LUMPUR",
          "state": "Wilayah Persekutuan"
        }
      },
      "legalEvents": {
        "incorporationDate": "1974-08-16"
      }
    },
    "associatedEntities": {
      "shareholders": [],
      "jointShareholders": [],
      "officers": [
        {
          "name": "TAN SRI TENGKU MUHAMMAD TAUFIK",
          "role": "officer",
          "providedRole": "Director",
          "address": "NO. 8, JALAN GR 3/4, JACARANDA, GARDEN RESIDENCE,  MALAYSIA, 63000, Selangor, CYBERJAYA",
          "startDate": "2018-10-14",
          "dateOfBirth": "1974-02-05",
          "additionalAssociatedEntityData": {
            "formattedAddress": {
              "addressLine1": "NO. 8, JALAN GR 3/4",
              "addressLine2": "JACARANDA, GARDEN RESIDENCE,  MALAYSIA",
              "zip": "63000",
              "city": "CYBERJAYA",
              "state": "Selangor"
            }
          }
        },
        {
          "name": "TAN SRI DATO' SERI MOHD BAKKE BIN SALLEH",
          "role": "officer",
          "providedRole": "Director",
          "address": "NO.33, CHANGKAT DATUK SULAIMAN, TAMAN TUN DR ISMAIL KUALA LUMPUR  MALAYSIA, 60000, Wilayah Persekutuan, KUALA LUMPUR",
          "startDate": "2019-06-17",
          "dateOfBirth": "1954-07-12",
          "additionalAssociatedEntityData": {
            "formattedAddress": {
              "addressLine1": "NO.33, CHANGKAT DATUK SULAIMAN",
              "addressLine2": "TAMAN TUN DR ISMAIL KUALA LUMPUR  MALAYSIA",
              "zip": "60000",
              "city": "KUALA LUMPUR",
              "state": "Wilayah Persekutuan"
            }
          }
        },
        {
          "name": "SHAIK ABDUL RASHEED BIN ABDUL GHAFFOUR",
          "role": "officer",
          "providedRole": "Director",
          "address": "NO. 11, JALAN KERAMAT TEPI, DATO' KERAMAT MALAYSIA, 54000, Wilayah Persekutuan, KUALA LUMPUR",
          "startDate": "2025-03-20",
          "dateOfBirth": "1964-12-15",
          "additionalAssociatedEntityData": {
            "formattedAddress": {
              "addressLine1": "NO. 11, JALAN KERAMAT TEPI",
              "addressLine2": "DATO' KERAMAT MALAYSIA",
              "zip": "54000",
              "city": "KUALA LUMPUR",
              "state": "Wilayah Persekutuan"
            }
          }
        }
      ]
    },
    "industryActivityCode": {
      "activityCodes": [
        "06201",
        "46611"
      ],
      "activity": "EXPLOITATION OF OIL AND GAS, \nMARKETING OF PETROLEUM AND PETROLEUM PRODUCTS\nINVETSMENT HOLDING"
    },
    "providerSpecificData": {
      "latestAccounts": {
        "overdue": false
      },
      "residency": "Local"
    },
    "sources": [
      {
        "name": "Companies Commission of Malaysia (Suruhanjaya Syarikat Malaysia - SSM)",
        "info": null,
        "primary": true,
        "fields": [
          "$.status",
          "$.additionalData.legalEvents.incorporationDate",
          "$.legalForm",
          "$.additionalData.otherIdentifiers[1]",
          "$.industryActivityCode.activityCodes",
          "$.registrationNumber",
          "$.additionalData.otherIdentifiers[2]",
          "$.providedStatus",
          "$.industryActivityCode.activity",
          "$.name",
          "$.providerSpecificData.residency",
          "$.associatedEntities.officers",
          "$.additionalData.contactInformation.formattedAddress"
        ],
        "lastCheckedTime": "2025-10-21T06:52:46+00:00"
      },
      {
        "name": "Global Legal Entity Identifier Foundation",
        "info": null,
        "primary": false,
        "fields": [
          "$.additionalData.otherIdentifiers[0]"
        ],
        "lastCheckedTime": "2025-10-21T06:52:46+00:00"
      }
    ],
    "version": "company-v2.0"
  }
}
Response after for refresh dataset
{
  "datasetId": "E5E7878657ECB96E6CEC0E5E85B830A9",
  "kompanyId": "3452467203442351F826783329F504D0",
  "datasetName": "refresh",
  "datasetOptions": null,
  "info": null,
  "status": "COMPLETED",
  "requestTime": "2025-09-17T12:00:13+00:00",
  "responseTime": "2025-09-17T12:00:18+00:00",
  "estimatedDeliverySeconds": 68,
  "content": {
    "kompanyId": "3452467203442351F826783329F504D0",
    "countryCode": "MY",
    "countryName": "Malaysia",
    "state": null,
    "registrationNumber": "19740100****",
    "name": "PETROLIAM NASIONAL**** (PETR***)",
    "status": "LIVE",
    "providedStatus": "EXISTING",
    "address": "TOWER 1,PETRONAS ****, K.LUMPUR CITY **** K.LUMPUR, 50088, Wilayah Persekutuan, KUALA LUMPUR",
    "legalForm": "PUBLIC LIMITED LIMITED BY SHARES",
    "additionalData": {
      "otherIdentifiers": [
        {
          "identifierName": "oldNumber",
          "identifierValue": "20076"
        },
        {
          "identifierName": "localNumber",
          "identifierValue": "19740100****"
        }
      ],
      "contactInformation": {
        "contactAddress": "TOWER 1,PETRONAS ****, K.LUMPUR CITY **** K.LUMPUR, 50088, Wilayah Persekutuan, KUALA LUMPUR" ,
        "formattedAddress": {
          "addressLine1": "TOWER 1,PETRONAS TWIN TOWER",
          "addressLine2": "K.LUMPUR CITY CENTRE K.LUMPUR",
          "zip": "50088",
          "city": "KUALA LUMPUR",
          "state": "Wilayah Persekutuan"
        }
      },
      "shares": {
        "shareCurrency": "RM"
      },
      "legalEvents": {
        "incorporationDate": "1974-08-16",
	    "registrationDate": "1974-08-15"
      },
      "capitalAmount": "500000000"
    },
    "associatedEntities": {
      "shareholders": [
        {
          "name": "FEDERAL LANDS ******* (INCORPORATED)",
          "role": "shareholder",
          "isCorporate": true,
          "shareNumber": "10"
        },
        {
          "name": "MINISTER OF FINANCE (INCORPORATED)",
          "role": "shareholder",
          "shareNumber": "99990"
        }
      ],
      "jointShareholders": [],
      "officers": [
        {
          "name": "TAN SRI ***** MUHAMMAD TAU***",
          "role": "officer",
          "providedRole": "Director",
          "address": "NO. 8, JALAN GR 3/4, JACARANDA, GARDEN RESIDENCE,  MALAYSIA, 63000, Selangor, CYBERJAYA",
          "startDate": "2018-10-14",
          "dateOfBirth": "1974-02-05",
          "additionalAssociatedEntityData": {
            "formattedAddress": {
              "addressLine1": "NO. 8, JALAN GR 3/4",
              "addressLine2": "JACARANDA, GARDEN RESIDENCE,  MALAYSIA",
              "zip": "63000",
              "city": "CYBERJAYA",
              "state": "Selangor"
            }
          }
        },
        {
          "name": "TAN SRI ****' SERI MOHD BAKKE BIN SAL****",
          "role": "officer",
          "providedRole": "Director",
          "address": "NO.33, CHANGKAT DATUK SULAIMAN, TAMAN TUN DR ISMAIL KUALA LUMPUR  MALAYSIA, 60000, Wilayah Persekutuan, KUALA LUMPUR",
          "startDate": "2019-06-17",
          "dateOfBirth": "1954-07-12",
          "additionalAssociatedEntityData": {
            "formattedAddress": {
              "addressLine1": "NO.33, CHANGKAT DATUK SULAIMAN",
              "addressLine2": "TAMAN TUN DR ISMAIL KUALA LUMPUR  MALAYSIA",
              "zip": "60000",
              "city": "KUALA LUMPUR",
              "state": "Wilayah Persekutuan"
            }
          }
        }
      ],
      "ultimateBeneficialOwners": []
    },
    "industryActivityCode": {
      "activityCodes": [
        "06201",
        "46611"
      ],
      "activity": "EXPLOITATION OF OIL AND GAS, \nMARKETING OF PETROLEUM AND PETROLEUM PRODUCTS\nINVETSMENT HOLDING"
    },
    "providerSpecificData": {
      "latestAccounts": {
        "overdue": false
      },
      "residency": "Local"
    },
    "sources": [
      {
        "name": "Companies Commission of Malaysia (Suruhanjaya Syarikat Malaysia - SSM)",
        "info": null,
        "primary": true,
        "fields": [
          "$.additionalData.otherIdentifiers[0]",
          "$.registrationNumber",
          "$.additionalData.otherIdentifiers[1]",
          "$.providedStatus",
          "$.name",
          "$.providerSpecificData.residency",
          "$.additionalData.shares.shareCurrency",
          "$.status",
          "$.additionalData.legalEvents.incorporationDate",
          "$.legalForm",
          "$.industryActivityCode.activityCodes",
          "$.additionalData.shareCapitals",
          "$.industryActivityCode.activity",
          "$.additionalData.capitalAmount",
          "$.associatedEntities.officers",
          "$.associatedEntities.shareholders",
          "$.additionalData.contactInformation.formattedAddress"
        ],
        "lastCheckedTime": "2025-09-17T10:43:13+00:00"
      }
    ],
    "version": "company-v2.0"
  }
}