Developer news

News Australian data ownership updates

Australian data ownership updates

Posted 2023-08-01 | Updated 2023-09-27

Our upgrade for Australia will be ready by middle of September, delivering enhanced company and shareholder data. An accurate launch date will be published soon.

The planned upgrade will cover:

KYC API v1 superdataset

Share Data on a Company Level
- shareCapitals – upgrade to contain multiple groups of company share information
- shareType – new information for unit of ownership

{
"shareCapitals": [
    {
       "docId": "",
       "totalShares": "",
       "numShares": "",
       "totalPaid": "",
       "classTitle": "",
       "shareType":"A"       
    },
    {
       "docId": "",
       "totalShares": "",
       "numShares": "",
       "totalPaid": "",
       "classTitle": "",
       "shareType":"B"    
    },
    {
       "docId": "",
       "totalShares": "",
       "numShares": "",
       "totalPaid": "",
       "classTitle": "",
       "shareType":"C"    
    },
    {
       "docId": "",
       "totalShares": "",
       "numShares": "",
       "totalPaid": "",
       "classTitle": "",
       "shareType":"M"    
    },
    {
       "docId": "",
       "totalShares": "",
       "numShares": "",
       "totalPaid": "",
       "classTitle": "",
       "shareType":"ORD"    
    }   
   ]

Share Data on a Shareholder Level
- shareCapitals – introducing to the shareholder level in order to capture the ownership information for each shareholder. Data for one shareholder can contain multiple groups of share data.
- shareType – new field explaining the type of share that the shareholder holds
- isBeneficiallyOwned – new flag indicating Beneficial Ownership character of a shareholder

{
"people": {
  "shareholder": [
    {    
      "name": "",
      "isCorporate": "1",
      "registrationNumber": "",
    "shareCapital":
    [ 
        {
        "shareNumber": "",
        "shareType":"A",
        "isBeneficiallyOwned":true
        },
        {
        "shareNumber": "",
        "shareType":"B",
        "isBeneficiallyOwned":true
        }
    ],     
      "address": [
        ""
      ]
    }       
  ]
}

Joint Shareholders
- In order to provide more comprehensive shareholder data, we are introducing Joint Shareholders for Australia JSON file, and they will be placed under “people”“jointShareholder”

{
 "jointShareholder": [
        {
          "shareCapital":
        [
            {
            "shareNumber": "",
            "shareType":"",
            "isBeneficiallyOwned":false
             }   
        ],
          "shareholder": [
            {
              "name": "",
              "type": "",
              "address": [
                ""
              ]
            },
            {
              "name": "",
              "type": "",
              "address": [
                ""
              ]
            }
          ]
        }
      ]
    }

KYC API v2 enhanced dataset

Share Data on a Company Level
- shareCapitals – will be positioned under the additionalData, and will contain multiple groups of shares for a company
- documentId – new naming of the field docId
- shareType – new field describing the share type of a share group

{
"additionalData": {
    "formattedAddress": {
      "region": "",
      "zip": "",
      "state": "",
      "street": "",
      "careOf": "",
      "addressLine2": "",
      "country": "",
      "shareCapital": [
        {
           "documentId": "",
           "totalShares": "",
           "totalPaid": "",
           "classTitle": "",
           "shareType":""       
        },
        {
           "documentId": "",
           "totalShares": "",
           "totalPaid": "",
           "classTitle": "",
           "shareType":""    
        },
        {
           "documentId": "",
           "totalShares": "",
           "totalPaid": "",
           "classTitle": "",
           "shareType":""    
        },
        {
           "documentId": "",
           "totalShares": "",
           "totalPaid": "",
           "classTitle": "",
           "shareType":""    
        },
        {
           "documentId": "",
           "totalShares": "",
           "totalPaid": "",
           "classTitle": "",
           "shareType":""    
        }   
       ]
    }

Share Data on a Shareholder Level
- numberOfShares – new naming for the field shareNumber
- shareType – new field explaining the type of share which shareholder holds
- isBeneficiallyOwned – new flag indicating Beneficial Ownership character of a shareholder

Joint Shareholders
- In KYC API V2 Enhanced dataset, the joint shareholders will be placed under “associatedEntities”“jointShareholder”

{
"jointShareholder": [
  {
    "shareCapital":
      [
          {
    "numberOfShares": "",
    "shareType":"", 
    "isBeneficiallyOwned":false
           }   
      ],
    "role": "jointShareholder",
    "shareholder": [
      {
        "name": "",
        "role": "shareholder",
        "additionalAssociatedEntityData": {
          "formattedAddress": {
            "region": "",
            "zip": "",
            "state": "",
            "street": "",
            "country": ""
          },
          "type": ""
        }
      },
      {
        "name": "",
        "role": "shareholder",
        "additionalAssociatedEntityData": {
          "formattedAddress": {
            "region": "",
            "zip": "",
            "state": "",
            "street": "",
            "country": ""
          },
          "type": "" 
        }
      }
    ]         
}

Back Next