
Developer news
KYC API: Upcoming changes to our connection to the Australian register
Summary
Data improvements
We are pleased to share details of the upcoming updates to datasets, including the addition of new fields and enhancements to existing ones. 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 versions, unless indicated otherwise.
Refresh dataset
New fields
- extradata.otherNames / additionalData.otherNames.tradingNames (for ABR companies)
- extraData.registrationDate / content.additionalData.legalEvents.registrationDate
Enriched fields
- legalForm / content.legalForm
- extradata.oldNames / content.additionalData.otherNames.oldNames
- extraData.providedStatus / content.providedStatus
- content.additionalData.subclass (KYC API v2)
Super dataset
New fields
- people.officer.startDate / content.associatedEntities.officers.startDate
- associatedEntities.officer.placeOfbirth (KYC API v2)
Enriched fields
- legalForm / content.legalForm
- extraData.providedStatus / content.providedStatus
- people.officer.isCorporate / associatedEntities.officer.isCorporate
- content.additionalData.subclass (KYC API v2)
Data refinement
Updated address format
To enhance our data quality, uphold product integrity, and improve the user experience, we are implementing the following modifications to the addresses displayed for the Australian register. We will introduce the field “addressLine1” where “addressLine2” is currently shown. Additionally, all instances of “addressLine2” will be removed from KYC API v2. Please refer to the details below regarding the affected fields:
Additional fields to KYC API v1 and KYC API v2
- formattedAddress.addressLine1 / content.additionalData.contactInformation.formattedAddress.addressLine1
- people.officer.address / content.associatedEntities.officers.additionalAssociatedEntityData.formattedAddress.addressLine1
- people.shareholder.address / content.associatedEntities.shareholders.additionalAssociatedEntityData.formattedAddress.addressLine1
Removed fields from KYC API v2
- additionalData.contactInformation.formattedAddress.addressLine2
- associatedEntities.officers.additionalAssociatedEntityData.formattedAddress.addressLine2
- associatedEntities.shareholders.additionalAssociatedEntityData.formattedAddress.addressLine2
Adjustment of legal events
To improve data accuracy, we have decided to utilize registrationDate as field name instead of incorporationDate for Australia as it more accurately reflects the mapped value. To minimize disruption for clients using KYC API v1, we will continue to display the incorporationDate in KYC API v1. Furthermore, to maintain product integrity, the incorporationDate will be removed from KYC API v2.
Conforming shareholder type
Aligned with this approach, the content.associatedEntities.shareholders.additionalAssociatedEntityData.type field will be excluded entirely from KYC API v2 to ensure consistency and clarity in data handling. Moving forward, we will use the enhanced logic of the isCorporate field to deliver this information. This feature is now included in this release for your convenience.
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": "589109AFE2C5918D6DD67F37FDA180B4",
"kompanyId": "177136F76A780E978D26AF211C38A208",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-05-22T11:28:59+00:00",
"responseTime": "2025-05-22T11:29:01+00:00",
"estimatedDeliverySeconds": 86,
"content": {
"kompanyId": "177136F76A780E978D26AF211C38A208",
"countryCode": "AU",
"countryName": "Australia",
"state": null,
"registrationNumber": "145360818",
"name": "ROBINSONS (BENDIGO) PTY LTD",
"status": "LIVE",
"providedStatus": null,
"address": "CASTLEMAINE, 3450, VIC",
"legalForm": "Australian Proprietary Company",
"additionalData": {
"subClass": "Limited By Shares",
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "145360818"
}
],
"contactInformation": {
"formattedAddress": {
"zip": "3450",
"region": "CASTLEMAINE",
"state": "VIC"
}
},
"legalEvents": {
"incorporationDate": "2010-07-22"
}
},
"associatedEntities": {
"shareholders": [],
"officers": []
},
"industryActivityCode": null,
"providerSpecificData": {
"latestAccounts": {
"overdue": false
},
"asic": "145360818",
"abn": "15145360818"
},
"sources": [
{
"name": "Australian Securities and Investments Commission",
"info": null,
"primary": true,
"fields": [
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.providerSpecificData.asic",
"$.providerSpecificData.abn",
"$.additionalData.subClass",
"$.name",
"$.additionalData.contactInformation.formattedAddress"
],
"lastCheckedTime": "2025-05-22T11:29:01+00:00"
}
],
"version": "company-v2.0"
}
}
Response after for refresh dataset
{
"datasetId": "589109AFE2C5918D6DD67F37FDA180B4",
"kompanyId": "177136F76A780E978D26AF211C38A208",
"datasetName": "refresh",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-05-22T11:28:59+00:00",
"responseTime": "2025-05-22T11:29:01+00:00",
"estimatedDeliverySeconds": 86,
"content": {
"kompanyId": "177136F76A780E978D26AF211C38A208",
"countryCode": "AU",
"countryName": "Australia",
"state": null,
"registrationNumber": "1234579053",
"name": "RANDOM COMPANY NAME",
"status": "LIVE",
"providedStatus": "Registered",
"address": "CASTLEMAINE, 3450, VIC",
"legalForm": "Australian Proprietary Company, Limited By Shares",
"additionalData": {
"subClass": "Proprietary Company",
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "1234579053"
},
],
"otherNames": {
"oldNames": [
"TRUST COMPANY FIDUCIARY SERVICES LIMITED"
],
"tradingNames": [
"TRUST COMPANY TRADING LIMITED"
]
},
"contactInformation": {
"formattedAddress": {
"zip": "3450",
"region": "CASTLEMAINE",
"state": "VIC"
}
},
"legalEvents": {
"registrationDate": "2010-07-22"
}
},
"associatedEntities": {
"shareholders": [],
"officers": []
},
"industryActivityCode": null,
"providerSpecificData": {
"latestAccounts": {
"overdue": false
},
"asic": "145360818",
"abn": "15145360818"
},
"sources": [
{
"name": "Australian Securities and Investments Commission",
"info": null,
"primary": true,
"fields": [
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.providerSpecificData.asic",
"$.providerSpecificData.abn",
"$.additionalData.subClass",
"$.name",
"$.additionalData.contactInformation.formattedAddress"
],
"lastCheckedTime": "2025-05-22T11:29:01+00:00"
}
],
"version": "company-v2.0"
}
}
Response before for super dataset
{
"datasetId": "CC4A97D25AD4CFC63DF659006DA218A8",
"kompanyId": "FD51D6ADC05FCD0B7A86B94048F61A9C",
"datasetName": "super",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-05-22T11:56:06+00:00",
"responseTime": "2025-05-22T11:56:31+00:00",
"estimatedDeliverySeconds": 93,
"content": {
"kompanyId": "FD51D6ADC05FCD0B7A86B94048F61A9C",
"countryCode": "AU",
"countryName": "Australia",
"state": null,
"registrationNumber": "002193688",
"name": "WINNING APPLIANCES PTY LTD",
"status": "LIVE",
"providedStatus": "Registered",
"address": "REDFERN, 2016, NSW, 20A DANKS STREET, LEVEL 2",
"legalForm": "Australian Proprietary Company",
"additionalData": {
"subClass": "Limited By Shares",
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "002193688"
},
{
"identifierName": "bvdId",
"identifierValue": "AU002193688"
}
],
"contactInformation": {
"contactAddress": "REDFERN, 2016, NSW, 20A DANKS STREET, LEVEL 2",
"formattedAddress": {
"addressLine2": "LEVEL 2",
"street": "20A DANKS STREET",
"zip": "2016",
"region": "REDFERN",
"state": "NSW"
}
},
"shareCapitals": [
{
"documentId": "6EFFD7827",
"totalShares": "84650",
"numberOfShares": "0",
"totalPaid": "11001793.98",
"classTitle": "CLASS A",
"shareType": "A"
},
{
"documentId": "7EBV18580",
"totalShares": "3092647",
"numberOfShares": "0",
"totalPaid": "168830509.1",
"classTitle": "ORDINARY SHARES",
"shareType": "ORD"
}
],
"legalEvents": {
"incorporationDate": "1981-06-26",
"registrationDate": "1981-06-26"
}
},
"associatedEntities": {
"shareholders": [
{
"name": "FELIPE RAMIREZ LASTRICO",
"role": "shareholder",
"address": "REDFERN, 2016, NSW, 20A DANKS STREET, WINNING GROUP, LEVEL 2",
"shareCapitals": [
{
"numberOfShares": "41906",
"shareType": "A",
"isBeneficiallyOwned": true
}
],
"additionalAssociatedEntityData": {
"type": "PERSON",
"formattedAddress": {
"careOf": "WINNING GROUP",
"addressLine2": "LEVEL 2",
"street": "20A DANKS STREET",
"zip": "2016",
"region": "REDFERN",
"state": "NSW"
}
}
},
{
"name": "HERMAN CORP PTY LTD",
"role": "shareholder",
"isCorporate": true,
"registrationNumber": "151833555",
"incorporatedIn": "AU",
"address": "SYDNEY, 2000, NSW, 40 LIME STREET, BELL PARTNERS",
"shareCapitals": [
{
"numberOfShares": "958548",
"shareType": "ORD"
}
],
"additionalAssociatedEntityData": {
"formattedAddress": {
"careOf": "BELL PARTNERS",
"street": "40 LIME STREET",
"zip": "2000",
"region": "SYDNEY",
"state": "NSW"
}
}
},
{
"name": "KATHARINA KUEHN",
"role": "shareholder",
"address": "REDFERN, 2016, NSW, 20A DANKS STREET, WINNING GROUP, LEVEL 2",
"shareCapitals": [
{
"numberOfShares": "41906",
"shareType": "A",
"isBeneficiallyOwned": true
}
],
"additionalAssociatedEntityData": {
"type": "PERSON",
"formattedAddress": {
"careOf": "WINNING GROUP",
"addressLine2": "LEVEL 2",
"street": "20A DANKS STREET",
"zip": "2016",
"region": "REDFERN",
"state": "NSW"
}
}
},
{
"name": "EQUITY PLAN SERVICES PTY LTD",
"role": "shareholder",
"isCorporate": true,
"registrationNumber": "621855838",
"incorporatedIn": "AU",
"address": "MELBOURNE, 3000, VIC, 1 COLLINS STREET, LEVEL 16",
"shareCapitals": [
{
"numberOfShares": "838",
"shareType": "A",
"isBeneficiallyOwned": true
}
],
"additionalAssociatedEntityData": {
"formattedAddress": {
"addressLine2": "LEVEL 16",
"street": "1 COLLINS STREET",
"zip": "3000",
"region": "MELBOURNE",
"state": "VIC"
}
}
},
{
"name": "YANDOO HOLDINGS PTY LTD",
"role": "shareholder",
"isCorporate": true,
"registrationNumber": "000891627",
"incorporatedIn": "AU",
"address": "REDFERN, 2016, NSW, 20A DANKS STREET, LEVEL 2",
"shareCapitals": [
{
"numberOfShares": "2000000",
"shareType": "ORD",
"isBeneficiallyOwned": true
}
],
"additionalAssociatedEntityData": {
"formattedAddress": {
"addressLine2": "LEVEL 2",
"street": "20A DANKS STREET",
"zip": "2016",
"region": "REDFERN",
"state": "NSW"
}
}
},
{
"name": "AZLAU LLC",
"role": "shareholder",
"isCorporate": true,
"incorporatedIn": "US",
"address": "WILMINGTON DE 19808, 251 LITTLE FALLS DRIVE, UNITED STATES, C/- CORPORATION SERVICE COMPANY",
"shareCapitals": [
{
"numberOfShares": "134099",
"shareType": "ORD",
"isBeneficiallyOwned": true
}
],
"additionalAssociatedEntityData": {
"formattedAddress": {
"addressLine2": "C/- CORPORATION SERVICE COMPANY",
"street": "251 LITTLE FALLS DRIVE",
"region": "WILMINGTON DE 19808",
"country": "UNITED STATES"
}
}
}
],
"officers": [
{
"name": "JOHN RYDER WINNING",
"role": "officer",
"providedRole": "Director",
"address": "SURRY HILLS, 2010, NSW, 625 SOUTH DOWLING STREET",
"dateOfBirth": "1984-04-30",
"additionalAssociatedEntityData": {
"formattedAddress": {
"street": "625 SOUTH DOWLING STREET",
"zip": "2010",
"region": "SURRY HILLS",
"state": "NSW"
}
}
},
{
"name": "JOHN WILLIAM WINNING",
"role": "officer",
"providedRole": "Director",
"address": "DOUBLE BAY, 2028, NSW, 7 GLADSWOOD GARDENS, UNIT 1",
"dateOfBirth": "1952-06-21",
"additionalAssociatedEntityData": {
"formattedAddress": {
"addressLine2": "UNIT 1",
"street": "7 GLADSWOOD GARDENS",
"zip": "2028",
"region": "DOUBLE BAY",
"state": "NSW"
}
}
},
{
"name": "AMY COWPER",
"role": "officer",
"providedRole": "Secretary",
"address": "TENNYSON POINT, 2111, NSW, 3A DEEBLE STREET",
"dateOfBirth": "1975-04-26",
"additionalAssociatedEntityData": {
"formattedAddress": {
"street": "3A DEEBLE STREET",
"zip": "2111",
"region": "TENNYSON POINT",
"state": "NSW"
}
}
},
{
"name": "PRICEWATERHOUSECOOPERS",
"role": "officer",
"providedRole": "Appointed Auditor",
"isCorporate": true,
"address": "BARANGAROO, 2000, NSW, ONE INTERNATIONAL TOWERS WATERMANS QUAY",
"additionalAssociatedEntityData": {
"formattedAddress": {
"street": "ONE INTERNATIONAL TOWERS WATERMANS QUAY",
"zip": "2000",
"region": "BARANGAROO",
"state": "NSW"
}
}
},
{
"name": "YANDOO HOLDINGS PTY LTD",
"role": "officer",
"providedRole": "Ultimate Holding Company",
"isCorporate": true
}
],
"ultimateBeneficialOwners": []
},
"industryActivityCode": null,
"providerSpecificData": {
"latestAccounts": {
"overdue": false
},
"asic": "002193688",
"abn": "94002193688"
},
"sources": [
{
"name": "Australian Securities and Investments Commission",
"info": null,
"primary": true,
"fields": [
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.providerSpecificData.asic",
"$.providerSpecificData.abn",
"$.providedStatus",
"$.additionalData.legalEvents.registrationDate",
"$.additionalData.subClass",
"$.name",
"$.associatedEntities.officers",
"$.associatedEntities.shareholders",
"$.additionalData.contactInformation.formattedAddress"
],
"lastCheckedTime": "1747914984"
}
],
"version": "company-v2.0"
}
}
Response after for super dataset
{
"datasetId": "CC4A97D25AD4CFC63DF659006DA218A8",
"kompanyId": "FD51D6ADC05FCD0B7A86B94048F61A9C",
"datasetName": "super",
"datasetOptions": null,
"info": null,
"status": "COMPLETED",
"requestTime": "2025-05-22T11:56:06+00:00",
"responseTime": "2025-05-22T11:56:31+00:00",
"estimatedDeliverySeconds": 93,
"content": {
"kompanyId": "FD51D6ADC05FCD0B7A86B94048F61A9C",
"countryCode": "AU",
"countryName": "Australia",
"state": null,
"registrationNumber": "0026573468",
"name": "NOT REAL COMPANY",
"status": "LIVE",
"providedStatus": "Registered",
"address": "REDFERN, 2016, NSW, 20A DANKS STREET, LEVEL 2",
"legalForm": "Australian Proprietary Company, Limited By Shares",
"additionalData": {
"subClass": "Proprietary Company",
"otherIdentifiers": [
{
"identifierName": "localNumber",
"identifierValue": "0026573468"
}
],
"otherNames": {
"oldNames": [
"NOT REAL COMPANY OLD"
],
},
"contactInformation": {
"contactAddress": "REDFERN, 2016, NSW, 20A DANKS STREET, LEVEL 2",
"formattedAddress": {
"addressLine1": "LEVEL 2",
"street": "20A DANKS STREET",
"zip": "2016",
"region": "REDFERN",
"state": "NSW"
}
},
"shareCapitals": [
{
"documentId": "6EFFD7827",
"totalShares": "84650",
"numberOfShares": "0",
"totalPaid": "11001793.98",
"classTitle": "CLASS A",
"shareType": "A"
},
{
"documentId": "7EBV18580",
"totalShares": "3092647",
"numberOfShares": "0",
"totalPaid": "168830509.1",
"classTitle": "ORDINARY SHARES",
"shareType": "ORD"
}
],
"legalEvents": {
"incorporationDate": "1981-06-26",
"registrationDate": "1981-06-26"
}
},
"associatedEntities": {
"shareholders": [
{
"name": "FELIPE RAMIREZ LASTRICO",
"role": "shareholder",
"isCorporate": false,
"address": "REDFERN, 2016, NSW, 20A DANKS STREET, WINNING GROUP, LEVEL 2",
"shareCapitals": [
{
"numberOfShares": "41906",
"shareType": "A",
"isBeneficiallyOwned": true
}
],
"additionalAssociatedEntityData": {
"formattedAddress": {
"careOf": "WINNING GROUP",
"addressLine1": "LEVEL 2",
"street": "20A DANKS STREET",
"zip": "2016",
"region": "REDFERN",
"state": "NSW"
}
}
},
{
"name": "HERMAN CORP PTY LTD",
"role": "shareholder",
"isCorporate": true,
"registrationNumber": "151833555",
"incorporatedIn": "AU",
"address": "SYDNEY, 2000, NSW, 40 LIME STREET, BELL PARTNERS",
"shareCapitals": [
{
"numberOfShares": "958548",
"shareType": "ORD"
}
],
"additionalAssociatedEntityData": {
"formattedAddress": {
"careOf": "BELL PARTNERS",
"street": "40 LIME STREET",
"zip": "2000",
"region": "SYDNEY",
"state": "NSW"
}
}
},
{
"name": "KATHARINA KUEHN",
"role": "shareholder",
"isCorporate": "false"
"address": "REDFERN, 2016, NSW, 20A DANKS STREET, WINNING GROUP",
"shareCapitals": [
{
"numberOfShares": "41906",
"shareType": "A",
"isBeneficiallyOwned": true
}
],
"additionalAssociatedEntityData": {
"formattedAddress": {
"careOf": "WINNING GROUP",
"street": "20A DANKS STREET",
"zip": "2016",
"region": "REDFERN",
"state": "NSW"
}
}
},
],
"officers": [
{
"name": "JOHN RYDER WINNING",
"role": "officer",
"providedRole": "Director",
"startDate": "2021-08-21",
"address": "SURRY HILLS, 2010, NSW, 625 SOUTH DOWLING STREET",
"dateOfBirth": "1984-04-30",
"placeOfbirth": "United Kingdom",
"additionalAssociatedEntityData": {
"formattedAddress": {
"street": "625 SOUTH DOWLING STREET",
"zip": "2010",
"region": "SURRY HILLS",
"state": "NSW"
}
}
},
{
"name": "JOHN WILLIAM WINNING",
"role": "officer",
"providedRole": "Director",
"startDate": "2023-06-21",
"address": "DOUBLE BAY, 2028, NSW, 7 GLADSWOOD GARDENS, UNIT 1",
"dateOfBirth": "1952-06-21",
"placeOfbirth": "Taiwan",
"additionalAssociatedEntityData": {
"formattedAddress": {
"addressLine1": "UNIT 1",
"street": "7 GLADSWOOD GARDENS",
"zip": "2028",
"region": "DOUBLE BAY",
"state": "NSW"
}
}
},
{
"name": "YANDOO HOLDINGS PTY LTD",
"role": "officer",
"providedRole": "Ultimate Holding Company",
"isCorporate": true
}
],
"ultimateBeneficialOwners": []
},
"industryActivityCode": null,
"providerSpecificData": {
"latestAccounts": {
"overdue": false
},
"asic": "002193688",
"abn": "94002193688"
},
"sources": [
{
"name": "Australian Securities and Investments Commission",
"info": null,
"primary": true,
"fields": [
"$.status",
"$.additionalData.legalEvents.incorporationDate",
"$.legalForm",
"$.registrationNumber",
"$.additionalData.otherIdentifiers[0]",
"$.providerSpecificData.asic",
"$.providerSpecificData.abn",
"$.providedStatus",
"$.additionalData.legalEvents.registrationDate",
"$.additionalData.subClass",
"$.name",
"$.associatedEntities.officers",
"$.associatedEntities.shareholders",
"$.additionalData.contactInformation.formattedAddress"
],
"lastCheckedTime": "1747914984"
}
],
"version": "company-v2.0"
}
}