Skip to main content
POST
/
api
/
v3
/
verifications
/
kyb
/
aus
/
comprehensive
AUS KYB Comprehensive
curl --request POST \
  --url https://{environment-subdomain}.idmetagroup.com/api/v3/verifications/kyb/aus/comprehensive \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "trustValidationId": "{your_trust_validation_id}",
  "trustFlowId": 0,
  "businessIdentificationNumber": "123456789"
}
'
{
  "success": true,
  "message": "KYB verification processed successfully",
  "data": {
    "shareholders": {
      "total": 3,
      "data": {
        "individual": [
          {
            "entityType": "PERSON",
            "numberOfShares": "80",
            "isTranslated": false,
            "shareholderNameEN": "JOHN SMITH",
            "currency": "AUD",
            "beneficiallyHeldField": true,
            "jointlyHeldField": false,
            "shareType": "ORD",
            "shareholderLocation": "Unit 5, 100 Example Road, Sydney, NSW, 2000",
            "shareholderID": null
          }
        ]
      }
    },
    "companyInformation": {
      "total": 1,
      "data": [
        {
          "companyID": "123456789",
          "capital": [
            {
              "numberOfShares": "100",
              "currency": "AUD",
              "type": "ORDINARY",
              "capitalAmount": "100"
            }
          ],
          "entityType": "Australian Proprietary Company Limited By Shares",
          "name": {
            "companyName": "Sample Company Pty Ltd",
            "isTranslated": false
          },
          "companyStatus": "Registered",
          "companyIDOther1": "12345678901",
          "regAddress": {
            "city": "MELBOURNE",
            "postalCode": "3000",
            "addressLine1": "Level 10, 100 Example Street",
            "addressLine2": "Melbourne VIC",
            "state": "VIC",
            "full": "Level 10, 100 Example Street, Melbourne, VIC, 3000"
          },
          "incorpDate": "2020-01-15"
        }
      ]
    },
    "majorPerson": {
      "total": 1,
      "data": [
        {
          "role": "Director",
          "address": "Unit 1, 100 Example Road, Sydney",
          "dob": "1990-01-01",
          "enName": "JANE DOE",
          "isTranslated": false,
          "appointedDate": "2019-01-01"
        }
      ]
    }
  },
  "verificationStatus": "VERIFIED",
  "verificationStatusCode": 3,
  "trustFlowId": 155,
  "trustValidationId": "{your_trust_validation_id}",
  "verificationType": "aus_kyb_comprehensive",
  "metadata": null
}
Run a comprehensive Know Your Business verification on an Australian company using its ACN (Australian Company Number). The response is synchronous and includes:
  • Company Information — registered name, entity type, ACN and ABN, company status, registered and principal-place-of-business addresses, share capital, and incorporation date.
  • Shareholders — individuals and entities holding shares, with share count, share class, and whether the holding is beneficial or jointly held.
  • Major Persons — directors and other officers on record, with appointed date and address.

Authorizations

Authorization
string
header
required

Use Bearer {your_api_token} in the Authorization header.

Headers

Accept
string
default:application/json
Content-Type
string
default:application/json

Body

application/json
trustValidationId
string<uuid>
required

Trust Validation identifier returned by Create Verification.

trustFlowId
integer
required

Trust Flow identifier this verification belongs to.

businessIdentificationNumber
string
required

Australian Company Number (ACN) of the company to verify.

Response

200 - application/json

Verification processed successfully (sync).

Synchronous KYB response envelope. data.result contains the upstream registry payload (typically with CompanyInformation, Shareholders, and majorPerson sections).

success
boolean
message
string
data
object
verificationStatus
string
Example:

"VERIFIED"

verificationStatusCode
integer
Example:

3

trustFlowId
integer
trustValidationId
string<uuid>
verificationType
string

Plan identifier (for example, ph_kyb_comprehensive, aus_kyb_comprehensive).

metadata
object