Developer news

News KYC API v2: Upcoming changes to liveSearch response

KYC API v2: Upcoming changes to liveSearch response

Posted 2025-09-18 | Updated 2025-10-02

Summary

We would like to announce important changes to the KYC API v2 liveSearch field data value mapping within the response of the [POST] https://api.kompany.com/api/v2/company/liveSearch endpoint across several jurisdictions, scheduled for release on October 15, 2025.

These changes are the result of a recent review to align our data with official registers and to ensure all available fields are incorporated in our search responses.

Please refer to our documentation page under Search datapoint overview for the complete list, in an Excel format, of available search fields for each jurisdiction. This documentation will reflect the updated production state after the changes are deployed on October 15, 2025.

Changes

The changes are categorized into three types:

Field value removals: where the response will now show null instead of previously returned values.
Field value additions: where the response will now show data instead of null.
Field value modifications: where existing field values will be updated with new data formats.

Field value removals

The following jurisdictions will have specific data values removed from their liveSearch responses.

Jurisdiction	Field	Search Method	Data Change
HK (Hong Kong)	`status`	number	Removed (will show null)
US-FL (Florida)	`address`	number	Removed (will show null)
US-ND (North Dakota)	`address`	number	Removed (will show null)
US-WI (Wisconsin)	`address`	number	Removed (will show null)
US-WV (West Virginia)	`address`	number	Removed (will show null)
US-NJ (New Jersey)	`address`	number, name	Removed (will show null)

Request

curl --request POST \
  --url https://api.kompany.com/api/v2/company/liveSearch \
  --header 'content-type: application/json' \
  --header 'user_key: {secret}' \
  --data '{
    "countryCode":"HK",
    "searchMethod":"number",
    "searchValue":"72524448",
    "alternativeSource": null,
    "strictSearch":true,
    "limit":10
}'

Response now (as-is)

{
  "searchId": "95F713C59A5BAE520AE3C3C62B013B17",
  "countryCode": "HK",
  "searchMethod": "number",
  "searchValue": "72524448",
  "status": "COMPLETED",
  "requestTime": "2025-09-18T12:33:27+00:00",
  "responseTime": "2025-09-18T12:33:33+00:00",
  "searchResults": [
    {
      "kompanyId": "640A4D7ED0CC91F6F9C77F15FBA85FE3",
      "countryCode": "HK",
      "countryName": "Hong Kong",
      "state": null,
      "registrationNumber": "72524448",
      "name": "Sunlight Action Charitable Limited",
      "status": "CLOSED",
      "address": null,
      "additionalData": null,
      "sources": [
        {
          "name": "Hong Kong Companies Registry (公司註冊處)",
          "info": null,
          "primary": true,
          "fields": [
            "$.status",
            "$.registrationNumber",
            "$.name"
          ],
          "lastCheckedTime": "2025-08-15T04:25:47+00:00"
        }
      ]
    }
  ]
}

Response after changes (to-be)

{
  "searchId": "95F713C59A5BAE520AE3C3C62B013B17",
  "countryCode": "HK",
  "searchMethod": "number",
  "searchValue": "72524448",
  "status": "COMPLETED",
  "requestTime": "2025-09-18T12:33:27+00:00",
  "responseTime": "2025-09-18T12:33:33+00:00",
  "searchResults": [
    {
      "kompanyId": "640A4D7ED0CC91F6F9C77F15FBA85FE3",
      "countryCode": "HK",
      "countryName": "Hong Kong",
      "state": null,
      "registrationNumber": "72524448",
      "name": "Sunlight Action Charitable Limited",
      "status": null,
      "address": null,
      "additionalData": null,
      "sources": [
        {
          "name": "Hong Kong Companies Registry (公司註冊處)",
          "info": null,
          "primary": true,
          "fields": [
            "$.registrationNumber",
            "$.name"
          ],
          "lastCheckedTime": "2025-08-15T04:25:47+00:00"
        }
      ]
    }
  ]
}

Field value additions

The following jurisdictions will have specific data values added from their liveSearch responses.

Jurisdiction	Field	Search Method	Data Change
BH (Bahrain)	`englishNames`	number, name	Added (will show data instead of null)
NO (Norway)	`status`	name	Added (will show data instead of null)
KR (Korea)	`address`	number, name	Added (will show data instead of null)
IT (Italy)	`address`	number	Added (will show data instead of null)
GR (Greece)	`address`	number, name	Added (will show data instead of null)
US-RI (Rhode Island)	`address`	name	Added (will show data instead of null)

Request

curl --request POST \
  --url https://api.kompany.com/api/v2/company/liveSearch \
  --header 'content-type: application/json' \
  --header 'user_key: {secret}' \
  --data '{
    "countryCode":"IT",
    "searchMethod":"number",
    "searchValue":"MI2070938",
    "alternativeSource": null,
    "strictSearch":true,
    "limit":10
}'

Response now (as-is)

{
  "searchId": "0B865D9CD884D2E7494027C3AD8E7EEB",
  "countryCode": "IT",
  "searchMethod": "number",
  "searchValue": "MI2070938",
  "status": "COMPLETED",
  "requestTime": "2025-09-18T14:13:01+00:00",
  "responseTime": "2025-09-18T14:13:02+00:00",
  "searchResults": [
    {
      "kompanyId": "3368FD15F6ED0282F47D42A03E0D4AD9",
      "countryCode": "IT",
      "countryName": "Italy",
      "state": null,
      "registrationNumber": "MI2070938",
      "name": "MDP MANAGEMENT S.R.L.",
      "status": "LIVE",
      "address": null,
      "additionalData": null,
      "sources": [
        {
          "name": "Registro imprese",
          "info": null,
          "primary": false,
          "fields": [
            "$.status",
            "$.registrationNumber",
            "$.name"
          ],
          "lastCheckedTime": "2024-12-03T12:28:48+00:00"
        }
      ]
    }
  ]
}

Response after changes (to-be)

{
  "searchId": "0B865D9CD884D2E7494027C3AD8E7EEB",
  "countryCode": "IT",
  "searchMethod": "number",
  "searchValue": "MI2070938",
  "status": "COMPLETED",
  "requestTime": "2025-09-18T14:13:01+00:00",
  "responseTime": "2025-09-18T14:13:02+00:00",
  "searchResults": [
    {
      "kompanyId": "3368FD15F6ED0282F47D42A03E0D4AD9",
      "countryCode": "IT",
      "countryName": "Italy",
      "state": null,
      "registrationNumber": "MI2070938",
      "name": "MDP MANAGEMENT S.R.L.",
      "status": "LIVE",
      "address": "CORSO VITTORIO EMANUELE II, 37/B, MILANO, 20122",
      "additionalData": null,
      "sources": [
        {
          "name": "Registro imprese",
          "info": null,
          "primary": false,
          "fields": [
            "$.status",
            "$.registrationNumber",
            "$.name",
            "$.address"
          ],
          "lastCheckedTime": "2024-12-03T12:28:48+00:00"
        }
      ]
    }
  ]
}

Field value modifications

The following jurisdictions will have specific data values changed from their liveSearch responses.

Jurisdiction	Field	Search Method	Data Change
NL (Netherlands)	`address`	number, name	Modified (will show different value)
NO (Norway)	`address`	number, name	Modified (will show different value)

Request

curl --request POST \
  --url https://api.kompany.com/api/v2/company/liveSearch \
  --header 'content-type: application/json' \
  --header 'user_key: {secret}' \
  --data '{
    "countryCode":"NO",
    "searchMethod":"number",
    "searchValue":"989270699",
    "alternativeSource": null,
    "strictSearch":true,
    "limit":10
}'

Response now (as-is)

{
  "searchId": "9D862F4CB1272AABF6F5600E8EFC2F0B",
  "countryCode": "NO",
  "searchMethod": "number",
  "searchValue": "989270699",
  "status": "COMPLETED",
  "requestTime": "2025-09-18T14:28:07+00:00",
  "responseTime": "2025-09-18T14:28:08+00:00",
  "searchResults": [
    {
      "kompanyId": "F6CE9FDF2B0C57F4233F0B3DADFF1E94",
      "countryCode": "NO",
      "countryName": "Norway",
      "state": null,
      "registrationNumber": "989270699",
      "name": "HOME AS",
      "status": "LIVE",
      "address": "6823, Nordstrandsvegen 10, SANDANE, GLOPPEN, SANDANE, Norge",
      "additionalData": null,
      "sources": [
        {
          "name": "Brønnøysund Register Centre (Brønnøysundregistrene)",
          "info": null,
          "primary": true,
          "fields": [
            "$.status",
            "$.registrationNumber",
            "$.name",
            "$.address"
          ],
          "lastCheckedTime": "2025-02-08T19:45:12+00:00"
        }
      ]
    }
  ]
}

Response after changes (to-be)

{
  "searchId": "9D862F4CB1272AABF6F5600E8EFC2F0B",
  "countryCode": "NO",
  "searchMethod": "number",
  "searchValue": "989270699",
  "status": "COMPLETED",
  "requestTime": "2025-09-18T14:28:07+00:00",
  "responseTime": "2025-09-18T14:28:08+00:00",
  "searchResults": [
    {
      "kompanyId": "F6CE9FDF2B0C57F4233F0B3DADFF1E94",
      "countryCode": "NO",
      "countryName": "Norway",
      "state": null,
      "registrationNumber": "989270699",
      "name": "HOME AS",
      "status": "LIVE",
      "address": "Nordstrandsvegen 10, GLOPPEN, SANDANE, 6823, Norge",
      "additionalData": null,
      "sources": [
        {
          "name": "Brønnøysund Register Centre (Brønnøysundregistrene)",
          "info": null,
          "primary": true,
          "fields": [
            "$.status",
            "$.registrationNumber",
            "$.name",
            "$.address"
          ],
          "lastCheckedTime": "2025-02-08T19:45:12+00:00"
        }
      ]
    }
  ]
}

If you have any questions or need support in preparation for this change, please do not hesitate to contact us here: support team. We recommend reviewing any workflows or integrations that may be affected by these data changes to ensure smooth operation after the deployment.

Back Next