Australia

eKYB Prefill in Australia leverages Australia's source of truth to automatically retrieve and populate business information based on a company's registration number, including the business name, entity type, registration status, registration date, credit rating, and other corporate details, without requiring manual input from the user.

Source

Direct API approach

For general integration notes and shared response semantics, see the eKYB Prefill API Reference.

All module configurations and user data can be forwarded directly in the request for performing a Prefill lookup. This overrides existing configuration and data collected about the user.

Endpoint

POST /omni/externalVerification/ekyb-prefill

Request parameters

Tax ID formats

Australia uses two business identifier formats. Input must be numeric only — no other lengths or formats are accepted. Requests with an invalid format return a 400 error.

Sample request

{
    "plugins": ["ekyb-prefill"],
    "source": "AU_KYB_PREFILL",
    "country": "AU",
    "taxId": "51 824 753 556",
    "businessName": "ACME GROUP LIMITED",
    "address": "123 Example Street, Sydney NSW 2000, Australia"
}

Sample response

The Prefill response returns business data retrieved directly from the source of truth. Passthrough fields are returned as-is from the source, without fuzzy matching or verification scoring. Match fields (nameMatch, addressMatch) are only returned when the corresponding input (businessName, address) was submitted.

{
    "kyb-prefill": [
        {
            "tin": "51824753556",
            "vatNo": "51824753556",
            "name": "ACME GROUP LIMITED",
            "nameMatch": "Verified",
            "address": "123 Example Street, Sydney NSW 2000, Australia",
            "addressMatch": "Verified",
            "city": "Sydney",
            "postalCode": "2000",
            "entityType": "Australian Public Company",
            "registrationStatus": "Active",
            "registrationDate": "1998-03-15",
            "creditRating": "A",
            "creditRatingDescription": "Very Low Risk",
            "industry": "Retail Trade",
            "industryDesc": "Supermarket, grocery, and general retail trade operations",
            "turnover": { "currency": "AUD", "value": 69346000000 },
            "otherAddresses": [
                {
                    "type": "Principal Place of Business",
                    "otherAddress": "456 Sample Avenue, Melbourne VIC 3000, Australia"
                }
            ],
            "directors": [
                { "name": "John Sample Smith", "positionName": "Director" },
                { "name": "Jane Example Doe", "positionName": "Director" }
            ],
            "otherNames": [
                { "name": "ACME Retail", "businessNameType": "Main Trading Name" },
                { "name": "ACME Supermarkets", "businessNameType": "Main Trading Name" }
            ],
            "activityDesc": "Supermarket and Grocery Stores"
        }
    ]
}

Response fields

Registration status values

Error responses

For standard HTTP response codes, see the API Error Response page. Australia Prefill returns the following country-specific 400 errors.

taxId is missing, empty, or not 9 or 11 numeric digits:

{
    "status": 400,
    "error": "Bad Request",
    "message": "taxId must be a valid ACN (9 digits) or ABN (11 digits), numeric only",
    "path": "/omni/externalVerification/ekyb-prefill"
}

Any mandatory field (plugins, source, country, or taxId) is missing:

{
    "status": 400,
    "error": "Bad Request",
    "message": "must not be blank",
    "path": "/omni/externalVerification/ekyb-prefill"
}

Single Session Dashboard results

Prefill results are available on the Business tab in single Session view.