Developer news

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

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

Posted 2025-10-22 | Updated 2025-10-24

Summary

We would like to inform you that we have implemented the following changes to our connection with the Companies Control Department – Ministry of Industry and Trade – Hashemite Kingdom of Jordan on KYC API. As part of our ongoing improvements, we are introducing newly added and enhanced data fields that provide greater detail and accuracy. These enhancements are tailored to availability and visibility may vary depending on the entity. This ensures that the data presented aligns closely with what is provided by the register.

Data additions

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

people.officer.name / associatedEntities.officer.name
people.officer.role / associatedEntities.officer.providedRole
people.officer.startDate / content.associatedEntities.officers.startDate
formattedAddress.city / content.additionalData.contactInformation.formattedAddress.city
formattedAddress.poBox / content.additionalData.contactInformation.formattedAddress.poBox
formattedAddress.addressLine1 / content.additionalData.contactInformation.formattedAddress.addressLine1
formattedAddress.zip / content.additionalData.contactInformation.formattedAddress.zip
formattedAddress.region / content.associatedEntities.officers.additionalAssociatedEntityData.formattedAddress.region
extraData.phone / content.additionalData.contactInformation.phone
extraData.email / content.additionalData.contactInformation.email
extraData.paidupCapital / additionalData.shares.paidupCapital
signatoryRights / content.providerSpecificData.signatoryRights

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 applicable to both.

Refresh dataset

status
address / content.address
extraData.providedStatus / content.providedStatus
legalForm / content.legalForm
people.shareholder.name / content.associatedEntities.shareholders.name
people.shareholder.role / content.associatedEntities.shareholders.providedRole
people.shareholder.shareCapital / content.associatedEntities.shareholders.shareCapitals
people.shareholder.nationality / content.associatedEntities.shareholders.nationality
extraData.paidupCapital / additional_data.shares.paidupCapital
signatoryRights / content.providerSpecificData.signatoryRights

Data refinement

In order to maintain consistency with the data supplied by the register, we will henceforth combine the two fields listed below:

extraData.activity / content.industryActivityCode.activity
sicNaceCodes / content.industryActivityCode.activityCodes

Please find the after response 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 after for refresh dataset


{
  "datasetId": "C9951B3A7A5B83A96B000FF2A19307DD",
  "kompanyId": "4BEF0A5E8BCAE3589D8872E096AE623F",
  "datasetName": "refresh",
  "datasetOptions": null,
  "info": null,
  "status": "COMPLETED",
  "requestTime": "2025-09-11T08:49:56+00:00",
  "responseTime": "2025-09-11T08:50:06+00:00",
  "estimatedDeliverySeconds": 34,
  "content": {
    "kompanyId": "4BEF0A5E8BCAE3589D8872E096AE623F",
    "countryCode": "JO",
    "countryName": "Jordan",
    "state": null,
    "registrationNumber": "200122721",
    "name": "عماد كامل محمود غرايبه وشركاه",
    "status": "LIVE",
    "providedStatus": "قائمة - 1",
    "address": "اربد /بديعه, اربد, اربد",
    "legalForm": "توصية بسيطة",
    "additionalData": {
      "otherIdentifiers": [
        {
          "identifierName": "localNumber",
          "identifierValue": "200122721"
        },
        {
          "identifierName": "otherNumber",
          "identifierValue": "16393"
        }
      ],
      "contactInformation": {
        "email": "advo.k**[email protected]",
        "phone": [
          "0777882*27"
        ],
        "formattedAddress": {
          "poBox": "950545",
          "addressLine1": "اربد /بديعه",
          "zip": "11195",
          "city": "اربد",
          "region": "اربد"
        }
      },
      "shares": {
        "paidUpCapital": "0",
        "authorizedCapital": "10000"
      },
      "legalEvents": {
        "registrationDate": "2011-12-11"
      }
    },
    "associatedEntities": {
      "shareholders": [
        {
          "name": "مروان عماد كامل محمود غرايبه",
          "role": "shareholder",
          "providedRole": "موصــي",
          "nationality": "أردني",
          "shareCapitals": [
            {
              "numberOfShares": "2000"
            }
          ]
        },
        {
          "name": "غسان عماد كامل محمود غرايبه",
          "role": "shareholder",
          "providedRole": "موصــي",
          "nationality": "أردني",
          "shareCapitals": [
            {
              "numberOfShares": "2000"
            }
          ]
        },
        {
          "name": "عماد كامل محمود غرايبه",
          "role": "shareholder",
          "providedRole": "متضامن",
          "nationality": "أردني",
          "shareCapitals": [
            {
              "numberOfShares": "6000"
            }
          ]
        }
      ],
      "jointShareholders": [],
      "officers": [
        {
          "name": "معالي السيدة ناديا عبد الرؤوف سالم الروابدة",
          "role": "officer",
          "providedRole": "عضو مجلس ادارة",
          "startDate": "2022-03-31"
        },
        {
          "name": "شهم منيب الور",
          "role": "officer",
          "providedRole": "عضو مجلس ادارة",
          "startDate": "2022-03-31"
        }
      ]
    },
    "industryActivityCode": {
      "activityCodes": [
        "831021 - شراء اراضي واقامة شقق سكنية عليها وبيعها بدون فوائد ربوية"
      ]
    },
    "providerSpecificData": {
      "authorizedCapital": "10000",
      "latestAccounts": {
        "overdue": false
      },
      "signatoryRights": "الشريك عماد كامل محمود غرايبه منفردا بكافة الامور الماليه والاداريه والقضائيه والاخرى او من يفوضه   خطيا بذلك."
    },
    "sources": [
      {
        "name": "Companies Control Department - Ministry of Industry and Trade - Hashemite Kingdom of Jordan (دائرة مراقبة الشركات)",
        "info": null,
        "primary": true,
        "fields": [
          "$.providerSpecificData.signatoryRights",
          "$.additionalData.contactInformation.phone",
          "$.registrationNumber",
          "$.additionalData.otherIdentifiers[0]",
          "$.additionalData.otherIdentifiers[1]",
          "$.providedStatus",
          "$.name",
          "$.status",
          "$.legalForm",
          "$.additionalData.shares.paidUpCapital",
          "$.industryActivityCode.activityCodes",
          "$.additionalData.legalEvents.registrationDate",
          "$.providerSpecificData.authorizedCapital",
          "$.additionalData.shares.authorizedCapital",
          "$.associatedEntities.shareholders",
          "$.additionalData.contactInformation.formattedAddress"
        ],
        "lastCheckedTime": "2025-09-11T08:50:06+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

Back Next