Professional Documents
Culture Documents
API Connect Individual Product Guide (EAandECA) v.1.33
API Connect Individual Product Guide (EAandECA) v.1.33
Equifax Commercial
Apply
API Connect Product Guide v1.33
API Connect Individual Product Guide – Equifax Apply & Equifax Commercial Apply
Revision control
2
o Match type (Seq No 2.1.1.2) is optional.
o Length extended for title (Seq No 2.1.1.7.4), family-name (Seq No
2.1.1.7.5), first-given-name (Seq No 2.1.1.7.6) and other-given-name
(Seq No 2.1.1.7.7)
o Length corrected for address type (Seq No 2.1.3.1.6), property (Seq
No 2.1.3.1.8), street-name (Seq No 2.1.3.1.11), suburb (Seq No
2.1.3.1.13), directorship type (Seq No 2.1.7.3.1.4)
o Additional credit enquiry type
o Additional elements in the default structure: original
reason-to-report and latest reason-to-report and their associated
code (Seq No 2.1.5.3.1.25.1.6.3 and 2.1.5.3.1.25.1.7.3)
- Consumer account type AO –All other account types not valid in the request
- New Default reason to report code table (Section 8.7)
- Additional default status value (Section 8.8)
- Key Contributing Factors updated and enriched (Section 8.11)
- New tables for Special Score Values (Section 0)
1.2 20/06/2014 Revised during product development:
- Section 3.2.2 revised as account data Level 1 is not applicable to consumer
accounts anymore
- Section 3.7 updated to include more information about handling future use
fields
- Sections 4.9.3 and 5.2 updated to include more details about dynamic data
testing
- Additional note in relation to optional fields in section 6.2.1
- Request structure (section 6.2.2):
o Updated validation rule on address element to enforce a choice
between formatted address or unformatted address.
o Added new element in request is-credit-review (Seq No 2.3.4)
- Response structure (section 6.2.3):
o Corrected error cardinality and updated error/fault-code,
fault-string, fault-actor and detail as optional in the response
o Updated description for account/open-date, closed-date,
original-maximum-amount-credit, latest-maximum-amount-credit
and date-last-changed
o Added new elements in the account structure:
▪ account/account-reopen-date (2.1.5.3.1.15)
▪ account/defaults/default/is-accelerated-debt (Seq No
2.1.5.3.1.26.1.6) for future use only
o List of valid values for court action type (2.1.7.1.1.4) modified
o Updated business-name/business-name-id (2.1.7.4.1.10.5) as future
use only
o Updated sole-trader/ABN as optional in the response
o Updated length of characteristic/@key-characteristic
o Updated file-ban-report/reported-date attribute optional in the
response
- Appendix B updated to include an initial list of error codes and descriptions
1.3 11/08/2014 Revised during product development:
- Corrected cardinality for request elements (section 6.2.2):
o Corrected product-data-level (Seq No 1.5) to mandatory in the
request.
3
o Corrected enquiry-amount (Seq No 2.2.3) to mandatory in the
request.
- Corrected format for date elements (section 6.2.3):
o Updated length of datetime-requested (1.2) and datetime-generated
(1.3) from 19 to 30 and format to
CCYY-MM-DDThh:mm:ss.sss(+|-)hh:mm.
o Updated length of @last-extract-time (2.1.7.2.1.5, 2.1.7.3.1.6,
2.1.7.4.1.5) and @last-update-time (2.1.7.2.1.7, 2.1.7.3.1.8,
2.1.7.4.1.7) from 15 to 20 and format to hh:mm:ss.sss(+|-)hh:mm.
- Updated descriptions for special scores -903 and -902 in section 8.21.1.
1.4 27/09/2014 Revised during product development:
- Updated section ‘7.2 Appendix B: Product error codes and descriptions’ and
replaced with error code categorisations, cause and action table.
- Added section ‘7.2.1 Error samples’ table.
- Updated section 8.11.1 and 8.11.2 with two new special scores each
(KCF-029, KCF-031 and KCF-129, KCF-131 respectively)
- Changes to the data returned for possible match identity
o Updated format and validation rule to return @first-reported-date
for a possible match identity (section 6.2.3.2) – permissible. This is
applicable to Seq No 2.1.1.7.1, 2.1.3.1.1, 2.1.4.1.1.
o Updated format and validation rule to not return certain fields for a
possible match identity (section 6.2.3.2) – not permissible. This is
applicable to Seq No 2.1.1.11, 2.1.1.11.1, 2.1.1.12, 2.1.1.12.1.
1.5 01/11/2014 Revised during product development:
- Updated section 1.7 to include XML report style sheet and guides for the
transition from VedaScore 1.0/1.1 to VedaScore Apply® and Commercial
Credit Assess – Individual
- Added section 3.111 – XML report style sheet as a new feature available for
customers
- Updated section 5.2 Endpoint URLs with the production endpoint
1.6 28/11/2014 Revised during product development:
- Removed section and endpoint in relation to static data testing (stub). The
dynamic data test service is now fully functional, so the temporary static
data testing service is no longer required.
- Added Key Contributing Factors for VedaScore Apply® (KCF-040 in section
8.11.1)
- Removed KCF-111 and modified the name and description of KCF-106 (Lack
of Adverse Information) for Commercial Credit Assess – Individual
1.7 23/01/2015 Updated the examples in section 9 to align with new schema v2.0.4 changes.
1.7.1 27/01/2015 Updated the field attributes of certain elements in the product response:
- 2.3.1.2.2 ‘name’ to 50 (previously 20)
- 2.3.1.4.1.2 ‘name’ to 60 (previously 40)
- 3.1 ‘message’ to 300 (previously 150)
1.8 13/02/2015 Updated to include:
- Reference to the VedaConnect Previous Enquiry API documentation.
- Notes in relation to the Access Seeker product.
- Format and validation rules for 2.2.8 employer to clarify that only one
employer record can be submitted in the request.
4
1.8.1 23/02/2015 Updated the field attributes of certain elements in the product response:
- 1.2 ‘datetime-requested’ to 29 (previously 30)
- 1.3 ‘datetime-generated’ to 29 (previously 30)
- 2.1.5.2.1.7 ‘account-type’ to 35 (previously 30)
- 2.1.5.3.1.10.1 ‘@code’ to V (previously F)
- 2.1.5.2.1.7.1 ‘@code’ to V (previously F)
- 2.3.1.4.1.1 ‘@id’ to 10 (previously 6)
- 2.1.5.3.1.15 ‘loan-payment-method’ to 60
(previously 50)
- 2.1.7.3.1.13.5 ‘status’ to 60 (previously 20)
- 2.1.7.5.1.5 ‘type’ to 60 (previously 40)
- 2.1.7.5.1.11 ‘relationship’ to 30 (previously 25)
- 2.1.5.3.1.11 ‘relationship’ to 30 (previously 25)
- 2.1.7.1.1.11 ‘relationship’ to 30 (previously 25)
- 2.1.5.2.1.11 ‘relationship’ to 30 (previously 25)
- 2.3.1.3 ‘risk-odds‘ to 18 (previously 10)
Updated the description of ‘is-unlimited-credit’ field as a
result of ACRDS update.
5
1.15 01/05/2016 ● Added notes and comments around VedaScore Apply® (Telco) and VedaScore
Apply® (Utility) products.
● Updated section 3.3 to include additional scores for Telcos and Utility
products
● Added section 8.11.2 for KCFs for Telcos and Utilities
● Added section 8.21 for court types
● Added section 8.22.2 for special scores for Telcos & Utilities
1.15.1 01/06/2016 ● Added notes and comments for VedaScore Apply® (Alternative Lending)
product.
● Updated section 3.3 to include additional scores for Alternative lending
product.
● Combined section 8.11.2 with 8.11.1 and section 8.22.2 with 8.22.1
1.16 01/12/2016 ● Clarified the scenarios when possible matches are returned in section
6.2.3.5.
● Removed Files notes section (previously 6.2.3.2.5.1) as it is no longer
returned in the VedaScore Apply® response.
● Added section 3.8 for custom data blocks
● Updated section 3.2.2 to extend the possible fields for account data level 1.
● Updated XML sample list in section 9 with segment specific request and
response sample descriptions.
1.17 11/03/2017 Product names and channels names updated as part of Equifax rebranding
● ‘VedaScore Apply’ renamed to ‘Equifax Apply’
● ‘Commercial Credit Assess – Individual’ renamed to ‘Equifax Commercial
Apply’
● ‘VedaCheck’ renamed to ‘IQ Connect’
● ‘VedaConnect’ renamed to ‘API Connect’
1.18 7/12/2017 Amended:
● Hybrid, Synchronous and Asynchronous diagrams to show as API Connect
● A number of references to “Veda” which is now known in Australia as
“Equifax”.
● Additional text under street type
● Updated the format and validation rules for Seq. No 2.2.8.2 & 2.2.8.6
● Additional explanation on the Enquiry-Client-Reference in the request
(2.3.9).
● Updated the End Points URL - 5.2 & Added the IP Address
1.19 11/05/2018 ⮚ Individual Trading History Option added to the product:
● Section 2.5 – Individual Trading History Information product variation
description
● Section 3.9 – Key product features for Individual Trading History information,
and how to request
● Section 9.1 – Sample ITH variant request
● Section 9.2 – Sample ITH variant response
⮚ Appendix A –Appendix A –Tips for Matching to Individual Bureau Files
1.19.1 27/10/2018 ⮚ New Telco Negative Scorecards – EA_2.1_X_NR_TC, EA_2.1_XY_NR_TC - these
are recommended for Telcos.
⮚ Correction of 2.1.5.3.1.9.5 Transfer Reason was incorrectly previously marked for
“Future Use” but this field is being supplied. Document now includes
transfer-reason and @code
6
⮚ Section 8.28 – Transfer Reason Code Table added
⮚ Section 4.9 – Updates made on testing environment
⮚ Minor changes in wordings
1.20 10/12/2018 ⮚ Equifax Apply Partial product for Telcos added. Document reflects the necessary
changes.
⮚ Section 6.2.3.2.7.3 - Directorships had Individual Trading History fields incorrectly
greyed out, but the fields are being supplied. Document now includes these
fields.
⮚ Section 6.2.3.2.7.4 - Business-names had Individual Trading History fields
incorrectly greyed out, but the fields are being supplied. Document now includes
these fields.
⮚ Section 6.2.3.2.7.4 - Business-names had Proprietorships field incorrectly
labelled as Proprietors. Document now stands corrected.
⮚ Section 6.2.3.2.7.4 - Business-names had incorrectly not mentioned fields
current-directors and previous-directors, although these fields were being
provided. Document now stands corrected.
⮚ Section 8.2 - Consumer Account Type updated to explain Account Type ‘CC’ in
detail.
⮚ Section 8.18 - Relationship table updated to reflect relationship code 1 correctly.
⮚ Section 8.18.1 - Account Relationship mapping table added
1.21 15/04/2019 ⮚ Equifax Commercial Apply Telco New Score Card (recommended)
ECA_2.1_YX_NR_TC
⮚ Section 6.2.3.2.5.2 Accounts, 2.1.5.3.1.21.2 date-last-changed corrected to be an
attribute as defined in the schema
⮚ Section 8.19 Repayment History Status, definitions for statuses ‘O’ (other) and ‘P’
(pending) corrected
⮚ Section 6.2.2.2 Bureau-reference and Individual, 2.2.8.2 Name of Employer
validation rule updated
⮚ Section 8.8 Default Status, table updated, ‘S’ (settled) no longer a valid default
status
1.22 13/02/2020 ⮚ Section 8.8 Paid default definition updated
⮚ Section 8.8 Current no longer a valid default status
⮚ Section 8.8 Disputed Defaults no longer available on Equifax Consumer Bureau
⮚ Section 8.27 Industry Classification ‘Serv’ added
⮚ Added Appendix B – tips for entering Driver Licence Number
⮚ Section 2.1.5.3.1.13 account-open-date definition updated
⮚ 6.2.3.2.7.1 Court-actions note added on privacy credit reporting code 2014, that came
into effect from 14th February 2020
1.23 15/09/2020 ⮚ Section 8.27 Industry Classification ‘BNPL’ added for Buy Now Pay Later
Additionally added some other possible but less common Industry codes: for
completeness
FGOV – Federal Government, SGOV – State Government, LGOV – Local Government,
INDU – Industries, MISC – Miscellaneous, and OTHA - Other
1.24 14/12/2020 ⮚ Inclusion of new Comprehensive Score for Consumer lending: Equifax One Score (see 3.3
Scores, ONE_1.0_XY_CR & ONE_1.0_X_CR)
⮚ Addition of Section 8.11.5 New KCFs for Equifax One Score
⮚ The product name will appear as “Equifax Apply One Score” where one of the new
Equifax One Score scorecards has been requested.
⮚ Changes to the Alternative Lending Data Block to incorporate new Buy Now Pay Later
characteristics (see 3.8 Alternative Lending Data Block and Customer Data Block)
⮚ Section 8.11.4 – Table of KCFs for Telco, Utility and Alternative Lending Models
7
⮚ Authorised Agent enquiries have been updated to be for Commercial only (2.1.5.2,
2.1.5.2.1.4, 2.1.5.2.1.7 & 2.1.6.2 and table 8.5)
⮚ Some minor wording changes to reflect that EA and ECA are no longer “new” products
⮚ Minor revision of scorecard ordering in section 3.3 Scores.
⮚ Move of Appendix C Hybrid & Asynchronous Ticket Response Testing to end of document
⮚ Additional note on removing leading zero for 10 digit Victorian Driver’s Licences in
Appendix A.
⮚ Change in timeout to 45 seconds in section 4.4 to reflect current situation
1.25 15/02/2021 ⮚ Comparison sites – addition of One Score (B2C) scorecard id –Equifax One Score with
consumer facing Key Contributing Factors
1.26 25/06/2021 Updated to include:
⮚ New Buy Now Pay Later (BNPL) Consumer Account Types. BNPL Facility (BF) and BNPL
Transaction (BT)
⮚ How to access the new optional units of time for Term of Loan – ACRDS v2.1 allows Term
of Loan to be reported for an account in days, weeks, or years in addition to months.
Refer to section 3.11 Comprehensive Credit Reporting Term of Loan Unit Type
1.27 24/09/2021 Minor wording changes to the below One Score Key Contributing Factor (KCF) names and
descriptions. Note that the KCF codes have not changed.
⮚ KCF for Equifax One Score KCF-301, KCF-302, KCF-304, KCF-324, KCF-337 & KCF-338
⮚ KCF for Equifax One Score B2C for Comparison Sites KCF-301, KCF-302, KCF-324, KCF-326,
KCF-327, KCF-337 & KCF-338
1.28 14/02/2022 Updated for changes to the Australian Credit Reporting Data Standard (ACRDS) V3.0
DRAFT including:
⮚ Financial Hardship Information (FHI) will now be returned alongside repayment history
information. Refer to the Accounts section for details.
⮚ A new FHI data block with summary characteristics. Refer also to the Genesis Data Block
GuideTM v1.21 DRAFT. Refer to the Summary Data section for details.
⮚ Addition of a separate field for default new arrangement information. Refer to the
Defaults section within Accounts for details.
Removal of the CTEAU test environment endpoints. These are no longer in use and all testing
can be conducted via the CTA endpoint here.
1.30 23/05/2022 Updated for the release of the new One Score for Telco scorecards which are leveraged via
Equifax Apply (Telco).
➢ Section 2 - updated the scorecard id’s and recommended scorecards.
➢ Section 3.3 - Inclusion of new partial and negative Telco score for Telecommunication
providers: Equifax Apply (Telco) - One Score for Telco (see 3.3 Scores).
➢ Added - Section 8.12.7 KCF for One Score for Telco.
8
1.31 1/09/2022 Updated for the release of the new Equifax Commercial Apply (Telco) - scorecards
➢ Section 2 - updated the scorecard ids and recommended scorecards.
➢ Section 3.3 - Inclusion of new commercial partial and negative Telco score for
Telecommunication providers.
1.32 17/04/2023 Updated for the release of Consumer Credit Liability Information (CCLI) changes:
➢ Section: 2.1.5.3.1.20 Original Maximum Amount of Credit Available field will no longer
be returned in the API response and PDF report. However, Latest Maximum Amount
Credit will not change
1.33 14/09/2023 Update of Special Score Value table:
➢ Section: 8.24.1 Special Score Values - Equifax Apply, Equifax One Score and Equifax
Commercial Apply
9
COPYRIGHT NOTICE
Copyright © 2023 Equifax Pty Ltd., a wholly owned subsidiary of Equifax Inc. All rights reserved. Equifax and
EFX are registered trademarks of Equifax Inc.
CONFIDENTIALITY WARNING
This document is confidential, and its contents must not be disclosed or disseminated to any unauthorised party,
used or reproduced in any way without the prior written permission of Equifax Australia Information Services and
Solutions Ltd.
10
Table of Contents
Introduction 13
Individual consumer credit versus individual commercial credit 14
About individual enquiry products 15
Audience 15
Scope 16
Pre-requisites 16
Terminology 16
References 16
Product Variations 18
Product version 20
Permission type 20
Data level 21
Scorecard ID 22
Individual Trading History Information 23
11
Possible response types 36
Enquiry ID 36
Timeouts 37
Supported SOAP Bindings 37
Reserved XML characters 37
Request Validation 38
Overview 38
Validating addresses 38
Formatted addresses 38
Unformatted addresses 39
Validating dates 39
Error-handling 39
Testing Environment for Customers 39
Web Services 41
Operations 41
Endpoint URLs 41
12
Commercial-credit-file 89
File-notes 90
Public-record or consumer-credit-information 91
Court-actions 93
Disqualified-directorships 95
Directorships 96
Business-names 99
Personal-insolvencies 103
Sole-trader 105
Summary-data 106
Score-data 108
Possible-matches 110
File-ban-report 110
Retrieve Enquiry by ID 111
Business Overview 111
Request Overview 111
Request-by-enquiry-id 112
Response Overview 112
13
Loan Payment Method 126
Organisation Status 127
Organisation Type 127
Permission type 127
Personal Insolvency Status 127
Personal Insolvency Type 127
Relationship 128
8.18.1 Account Relationship Mapping 128
Repayment History Status 128
Financial Hardship Information 129
Score Impactors 129
Equifax Apply and Equifax Commercial Apply Score Impactors 129
Court Type 129
Special Score Values 129
Equifax Apply, Equifax One Score and Equifax Commercial Apply 129
VedaScore 1.1 129
Secured Credit 130
State 130
Street Type 130
Term type 131
Industry Classification 131
Transfer Reason 132
Term of Loan Unit Type 132
Examples 133
Request 133
Response 134
14
1 Introduction
The term Consumer Credit refers to any loan intended wholly or primarily for personal, family or household
purposes (as well as to acquire, refinance, renovate or improve residential investment properties). Consumer
credit is governed by Part IIIA of the Privacy Act 1988 (the Act) and credit information is defined in Section 6N of
the Act.
The term Commercial Credit is defined as credit (other than consumer credit) that is applied for by or provided to
an individual. Personal information relating to commercial credit is governed by the Australian Privacy Principles
of the Act.
As a direct consequence of this legal separation Equifax holds its individual credit information in two databases
(consumer and commercial). The footprints of consumer credit enquiries (a record of the information supplied in
service request) are recorded on the consumer database, while the footprints of commercial credit enquiries are
recorded on the commercial database.
Regardless of which type of credit is being provided or assessed, Credit Providers and Access Seekers can choose
to retrieve combined* credit information for the applicant and in this case the Equifax enquiry response includes
information from both the consumer and the commercial databases. The response also includes information from
the Equifax public record database.
Such enquiries are referred to as “Consumer + Commercial” or “Commercial + Consumer” enquiries depending on
the credit purpose as defined above. The underlying information is the same for both enquiries – they differ with
respect to the footprint they leave on the record, the treatment of publicly available information and the product
they utilise (with its related functionality and features).
● Equifax Apply (previously known as VedaScore Apply®) suite1 – which is intended for consumer credit
application assessment and includes the Consumer and Consumer + Commercial service.
● Equifax Commercial Apply (previously known as Commercial Credit Assess – Individual) suite2 – which is
intended for commercial credit application assessment and includes the Commercial only and Commercial
+ Consumer service.
*appropriate consents and permissions must be obtained from the applicant by the Credit Provider
1
All references to Equifax Apply include Equifax Apply® (Telco), Equifax Apply® (Utility) and Equifax Apply®
(Alternative Lending), unless specified otherwise.
2
All references to Equifax Commercial Apply include Equifax Commercial Apply (Telco) and Equifax Commercial
Apply (Utility), unless specified otherwise.
15
1.2 About individual enquiry products
Equifax Apply and Equifax Commercial Apply represent the latest generation in the Equifax credit origination
product suite leveraging comprehensive data. Equifax Apply is dedicated to individual consumer credit origination
whereas Equifax Commercial Apply focuses on individual commercial credit origination.
Equifax Apply and Equifax Commercial Apply both offer the option of including comprehensive credit data and
use the latest version of Equifax bureau scorecards designed to allow subscribers to obtain bureau-based risk
profiles (scores) on new credit applicants and to help subscribers make more informed credit assessment
decisions. Equifax Apply and Equifax Commercial Apply provide the solid base for Equifax Individual enquiries
with a flexible scoring solution to all Equifax customers.
Equifax Apply and Equifax Commercial Apply scorecards measure an applicant’s potential credit risk based on
Equifax data at the point of application and is a risk ranking tool to help credit providers assess an applicant’s
willingness to make payments.
Equifax Apply and Equifax Commercial Apply also offer customers currently using the older versions of Equifax
scored origination products the opportunity to upgrade to the next generation of products.
Equifax Apply (Telco), Equifax Apply (Utility) and Equifax Apply (Alternative Lending) are the credit origination
products built specifically for Telecommunication (Telco), Utility and Alternative Lending segments respectively.
These products offer additional features and capability to Telecommunications, Utility and Alternative Lending
companies over the standard Equifax Apply® product and use a new, improved scorecard specific to the segment.
Please note that Equifax Commercial Apply (Telco) and Equifax Commercial Apply (Utility) are also available.
Equifax Apply (Telco) product includes Negative and Partial data, Equifax Apply (Utility) and Equifax Apply
(Alternative Lending) products currently include only Negative data. Partial (for Utility) and Comprehensive (for
Alternative Lenders) versions of these products may be available in a future release (to be determined).
Equifax Apply and Equifax Commercial Apply are not backward compatible with previous versions of
VedaScore products. VedaScore 1.1 and VedaScore 1.0 products cannot be accessed using Equifax
Apply web services and vice versa.
1.3 Audience
The audience for this document is primarily:
● Those wishing to develop software to interface with API Connect Web Services for Equifax Apply and
Equifax Commercial Apply products
● Those wishing to understand the business rules related to Equifax Apply and Equifax Commercial Apply
products
This guide is suitable for Credit Providers and Agents of Credit Providers, as well as Agents of an Individual/Access
Seekers. As Access Seekers are acting on behalf of an Individual and are entitled to see all comprehensive data
held and there are some differences in the product. Access Seekers should specifically review the Notes for Access
Seekers (an example is shown below).
16
Description of note.
Telecommunication and Utility segment customers should specifically review the Notes for Telcos and Utilities (an
example is shown below).
Alternative Lending customers should specifically review the Notes for Alternative Lending Customers (an example
is shown below).
1.4 Scope
The scope of the document is primarily:
● Defining and describing the interfaces to Equifax’s web service methods to Equifax Apply services, which
are used to serve Equifax Apply and Equifax Commercial Apply products
● Defining the business rules related to the Equifax Apply services
1.5 Pre-requisites
There are three prerequisites before a client can use API Connect web services operations.
● Prerequisite 1 – Get Equifax Digital Certificates.
Why - You need Equifax Digital Certificates to establish a secure connection to API Connect over an HTTPS
channel. Please refer API Connect Getting Started Guide on how to establish a secure connection to API
Connect over HTTPS channel
● Prerequisite 2 –Get Username and Password.
Why - Once a secure channel is established, all SOAP messages sent over it need to be authenticated. This
authentication information is sent using SOAP headers.
● Prerequisite 3 –Get WSDL.
Why – The WSDL (Web Services Description Language) describes the location of the service and the
operations the service exposes. It is recommended to use the latest version of the WSDL to create your
client programs.
If you do not meet the above three prerequisites, please contact your Equifax account manager or Equifax
Technical Support.
1.6 Terminology
API Connect is the new brand name used for products offered over secure HTTPS channel using SOAP or VedaXML
protocol.
If you are not familiar with the API Connect products, VedaXML or SOAP interfaces, please refer to the API
Connect Getting Started Guide.
17
1.7 References
This product guide belongs to a package which also includes:
1. API Connect Channel Documentation - Equifax recommends prior reading of the following documents,
also published by Equifax to get a better understanding of the concepts and systems described in this
product guide
o API Connect Connectivity Guide
o API Connect Getting Started Guide
2. Equifax Apply – Individual Product Information Guide
3. Genesis Data BlockTM Guide: Equifax Apply and Equifax Commercial Apply product include a set of
hundreds of summary characteristics referred to as the Genesis Data BlockTM.
4. Genesis Data BlockTM Guide for Telcos and Utilities: Equifax Apply (Telco) and Equifax Apply (Utility)
products includes details on the additional 30+characteristics available as part of the Telco Data Block and
Utility Data Block delivered as part of these new services, as well as the extensive. Genesis Data Block.
5. vedascore-apply-v2.0 interface documents (which is shared between Equifax Apply and Equifax
Commercial Apply) and samples
o WSDL
o XSD
o XML sample requests and responses as defined in 9 - Examples.
o XML report style sheet
6. Test documentation - Equifax Apply and Equifax Commercial Apply – Customer Test Guide
7. Release notes
8. For customers transitioning from VedaScore 1.0 or 1.1 over API Connect, also refer to the following
documents:
o Equifax Apply and Equifax Commercial Apply Schema Migration Guide
o VedaScore 1.0 to Equifax Apply Schema Transition (spreadsheet)
o VedaScore 1.1 to Equifax Apply Schema Transition (spreadsheet)
9. For customers planning to use the previous enquiries API to retrieve PDF reports over API Connect, refer
to:
o API Connect Previous Enquiry – Application Programming Interface
This Product Guide is based on version 1.0 of the Australian Credit Reporting Data Standard (ACRDS) issued by
ARCA in January 2014. A copy of this data standard can be obtained from:
http://www.arca.asn.au/focus/australian-credit-reporting-data-standard.html
18
2 Product Variations
The product response is conditioned by:
● A product version
● A permission type
● A data level
● One or more scorecard IDs
● The type of Equifax customer submitting the enquiry
The following tables detail the scorecards that are available to API users. A maximum of 3 scorecard ids can be
requested in a product. It is recommended that the choice of scorecard be discussed with Equifax, please
reach out to your Equifax account manager for assistance.
19
Product Equifax Apply (Telco)
name
ECA_2.1_YX_NR_TC^
CCAI_2.0_YX_NR_TC^
VS_1.1_YX_NR_TC
20
Product name Equifax Apply (Alternative Lending) Controlled via
VS_1.1_X_NR VS_1.1_XY_NR
Only one Genesis Data BlockTM will be provided in the Equifax Apply product response regardless of
the number of scorecards requested. See note below for Telcos and Utilities. The characteristics in
this block will always reflect the maximum data level of the product selected by the customer. Refer
to section 3.6 Genesis Data BlockTM for more details.
21
An additional data block (Alternative Lending Data Block) will be provided in the Equifax Apply (Alternative
Lending) product response.
This version of the product guide relates to version 2.0 of Equifax Apply and Equifax Commercial Apply. When a
new product version is available, an updated version of this product guide will be released and include any
additional features and product variations
Definitions:
● Individual Consumer credit is intended wholly or partly for personal, family or household purposes or to
acquire, re-finance, maintain or improve a residential property for investment purposes. This includes
credit applications such as credit cards, mortgages, and personal loans.
● Individual Commercial credit is credit for commercial purposes, e.g. a sole trader, partner, director or
guarantor of a company or other investment properties such as shops and factories.
Depending upon the enquiry being made consent of the individual or notice to the individual is required prior to
accessing the relevant report.
22
Individual consumer credit is governed by Part IIIA of the Privacy Act 1988 (the Act) and credit information is
defined in Section 6N.
Personal information relating to individual commercial enquiries is governed by the Australian Privacy Principles of
the Act.
23
Note for Alternative Lending customers
Rules of Reciprocity also apply to Alternative Lending customers. Currently Equifax Apply
(Alternative Lending) supports Negative data level. Comprehensive data level is currently
unsupported and will be available in the future. Any Alternative Lender looking to supply and
receive Comprehensive data is advised to use the main Equifax Apply product at this time.
2.4 Scorecard ID
Multiple scores can be included in the response based on the request element <scorecard-id>. Refer to 3.3 -
Scores for the list of scorecard IDs.
If no scorecard ID is specified in the request, the system uses the latest scorecard based on permission type and
data level.
Configuring scorecard ID in the request helps ensure score stability when a new version of the score is released.
Over time, subscribers can remain on their current version of the score and transition gradually to the latest
version when ready.
Note that the choice of scorecard ID is limited depending on permission type and account data level. The product
data level needs to be higher or equal to the scorecard data level, e.g. a comprehensive score can only be
returned if the product data level is comprehensive (and subscriber is a comprehensive data contributor).
24
3 Key Product Features
This section only includes product features introduced in this version of the product. For a full view of the
response content, please refer to 6.2.3.2 - Report Response.
Full Identity Reporting (FIR) naturally extends previous functionality called Multiple Identity Reporting (MIR).
While MIR consolidated and removed duplicates of credit information across all the cross-referenced files for an
individual, it only displayed identity information of the Primary Matched Identity. FIR provides more insight into
the information Equifax holds on other Identities for that individual, such as:
● While a maximum number of 3 Addresses are returned for an individual, these are sourced from all the
cross-referenced files and tagged accordingly.
● Aliases /alternate names are shown for cross-referenced records.
● Date of birth, driver’s licence, gender and employer are shown. Where available these will be sourced
from the primary record, otherwise cross-referenced identities may be used as a source.
● Credit data such as credit enquiries and defaults will be sourced from all the cross-referenced files and
tagged accordingly.
FIR also introduces additional metadata date fields associated with the individual's personal information -
specifically their name, DOB, driver's licence, address and employment details. This data provides insight into
when that data item was first reported and last reported to Equifax. Although in the first instance such fields may
be empty in the responses that will be returned, they will be populated more frequently over time as our
consumer credit database gradually becomes enriched with this data.
25
Note for Alternative Lending customers
Equifax Apply (Alternative Lending) services also have Full Identity Reporting feature enabled.
Transfer Date ✔ ✔ ✔ ✔ ✔
Account Identifier ✔ ✔ ✔ ✔ ✔
26
Type of Account ✔ ✔ ✔ ✔ ✔
Relationship ✔ ✔ ✔ ✔ ✔
Open Date 🗶 🗶 🗶 ✔ ✔
Closed Date 🗶 🗶 🗶 ✔ ✔
Reopen Date 🗶 🗶 🗶 ✔ ✔
Term Type 🗶 🗶 🗶 ✔ ✔
Secured Credit 🗶 🗶 🗶 ✔ ✔
Term of Loan 🗶 🗶 🗶 ✔ ✔
Default Information 🗶 ✔ ✔ ✔ ✔
The symbol ✔ indicates that a data element will be included for this account data level if available.
Note that only account data levels 1 and 2 are available for individual commercial accounts.
For consumer accounts, account data level 4 is available to partial and comprehensive contributors and account
data level 5 is only available to comprehensive contributors only.
3.3 Scores
Equifax introduced a new scorecard to its range of scores in December 2020 – Equifax One Score. The new
scorecard is for Consumer Credit Providers and Access Seekers who have access to Comprehensive Data and is the
best Equifax scorecard built to date. Equifax has been able to include a much larger pool of Credit Provider
Comprehensive Credit Reporting (CCR) data than was available in the pilot, unleashed the full power of the
Comprehensive Data, included the superior Equifax Negative Consumer and Commercial bureau data, removed
the incoming origination enquiry, minimised any unintended bias and possible discriminatory factors, added new
27
BNPL and Geodemographic factors, maximised stability through Covid-19 and used some patented Equifax Neuro
DecisionTM Technology to produce a scorecard that is vastly more predictive that Equifax Apply Comprehensive and
all previous Equifax (and Veda) Australian scorecards.
Financial Hardship Information is not considered for scoring. Hence, no changes to any of Equifax Scores.
Equifax Apply and Equifax Commercial Apply previously introduced the VedaScore 2.0 suite which was built on
the highly successful Comprehensive Credit Reporting Pilot in 2011/12, and provided a greatly improved scoring
solution to Equifax customers as it incorporated not only Enquiry, Demographic and Default information but also
the Consumer Comprehensive Reporting Data (where applicable).
There are a total of 13 scorecards available in the suite now (plus 15 specialist scorecards – see over) depending
on the credit providers Data Level (access to Comprehensive Credit Reporting data or Negative data) and the
purpose (Consumer or Commercial) and permission type of the enquiry. Provided that the individual has given
appropriate consent, the scores available include Consumer, Consumer + Commercial and for individual
commercial purposes - Commercial + Consumer and Commercial only. Equifax One Score is now available in
Comprehensive Data Level only, for Consumer purpose only (not for Commercial borrowing).
Up to 3 scorecard ids can be ordered. Equifax recommends using scorecards as high up in this table as possible, i.e.
Equifax One Score over Equifax Apply, Consumer + Commercial over Consumer only and Comprehensive over
negative (where applicable). Account Managers can help engage Equifax Analytics and Advisory consultants to
help choose the right scorecard ids for each customers situation, via either a simple score comparison exercise or
something more in-depth.
Four VedaScore 1.1 scorecards remain available to facilitate the transition from 1.1 and are not recommended as a
sole scorecard at this time.
Score name Score Version Score Data level Permission type Scorecard ID
ONE_1.0_XY_CR or
Consumer + Commercial
Equifax One Score 1.0 Comprehensive ONE_1.0_XY_CR_B2C
Consumer ONE_1.0_X_CR
Consumer + Commercial VSA_2.0_XY_CR
Comprehensive
Consumer VSA_2.0_X_CR
Equifax Apply 2.0
Consumer + Commercial VSA_2.0_XY_NR
Negative
Consumer VSA_2.0_X_NR
Comprehensive Commercial + Consumer CCAI_2.0_YX_CR
Equifax
2.0 Commercial + Consumer CCAI_2.0_YX_NR
Commercial Apply Negative
Commercial CCAI_2.0_Y_NR
Consumer + Commercial VS_1.1_XY_NR
Consumer VS_1.1_X_NR
VedaScore 1.1 Negative
Commercial + Consumer VS_1.1_YX_NR
Commercial VS_1.1_Y_NR
28
Ten additional scorecards are available for Equifax Apply (Telco) and Equifax Apply (Utility) products and cover
Consumer, Consumer + Commercial and Commercial + Consumer type.
For Telcos the new Equifax One Score for Telco scorecards utilising both Partial and Negative data sets have been
added. It is recommended that Telcos use the new scorecard/s in preference to the existing scorecard.
~ Recommended.
^ Not recommended – customers are requested to move to the new recommended scorecard id.
Score name Score Version Score Data level Permission type Scorecard ID
Consumer + Commercial VSA_2.0_XY_NR_UT
Equifax Apply (Utility) 2.0 Negative
Consumer VSA_2.0_X_NR_UT
Two scorecards are developed for Equifax Apply (Alternative Lending) and cover Consumer and Consumer +
Commercial permission type.
Score name Score Version Score Data level Permission type Scorecard ID
29
Equifax Apply (Alternative Consumer + Commercial VSA_2.0_XY_NR_ALT
2.0 Negative
Lending) Consumer VSA_2.0_X_NR_ALT
Consumer + Commercial VS_1.1_XY_NR
VedaScore 1.1 Negative
Consumer VS_1.1_X_NR
When new versions of the score are introduced in the future, new scorecard IDs will be available in Equifax Apply.
Credit Providers who are loading Comprehensive data onto the Equifax consumer credit database (including
repayment history information) are eligible to use all models.
Telco Companies who are loading partial data (i.e. CCR data excluding Repayment History Information) are eligible
to see partial and negative scoring models only. Over time, partial services may be developed for Utility
Companies and Credit providers based on the demand. All other users and contributors of default information are
only able to use negative scoring models.
All Scorecard models used in Equifax Apply and Equifax Commercial Apply deploy the Masterscale in line with the
VedaScore 1.1 product suite (previously reported as veda-score in the VedaScore 1.1 XML response). This
Masterscale returns an integer value between -200 and 1200 and so offers customers a number of advantages
including simplicity and consistency of meaning across different Equifax products.
Equifax Apply and Equifax Commercial Apply do not include relative risk, percentile and VedaScore 1.1 index.
Population odds and applicant odds have also been removed; the latter being displaced by the new
risk odds value.
Note for Access Seekers
Access Seekers have access to all scorecards (excluding Equifax Apply (Telco) and Equifax Apply
(Utility)) within any given report permission type context and just need to specify which ones they
require in the request.
30
Four KCFs are associated with a score for individuals with no insolvency on file. Only one KCF will be generated for
individuals with insolvency on file. Refer to 8.11 - Key Contributing Factors (KCF) for a complete list of key
contributing factors.
o The negative data summarised by 120+ characteristics and, where Consumer + Commercial or
Commercial + Consumer information is requested, incorporates Consumer and Commercial data.
o The CR data incorporates 320+ new Consumer characteristics.
o Partial data items are included within the CR set and are currently available for Telcos.
o As per international best practice, the set includes 10+ “own” variables – for example “Own Worst
Account Payment Status”. “Own” variables will be derived based on the Credit Provider’s subscriber
setup with Equifax.
The characteristics included in the Genesis Data BlockTM for each transaction will be based on the product data
level (Negative or Comprehensive) specified in the request. CR characteristics will only be included if data level is
Comprehensive.
31
Refer to the Genesis Data BlockTM Guide for a complete list of characteristics included in the Genesis Data
BlockTM.
A subscriber can also request to have a fully customised data block if the existing data blocks do not meet their
needs. Please contact your Equifax account manager to discuss what options are available to you.
For each of the companies and businesses that the individual holds a current or previous directorship or
proprietorship for the trading history variant returned information about the number of enquiries, defaults,
mercantile enquiries, court writs and actions, directorships and proprietorships/proprietors.
In order to request the trading history information for an individual, in the request to API Connect specify a
custom input parameter key “ITH” with the value “true” (Refer to 6.2.2.1 Enquiry Header Seq no 1.8.1.1 and Seq
no 1.8.1.2).
32
However, Equifax recommends that subscribers build their client systems in readiness to accept and ingest, where
possible, fields marked as “future use” in the response. This will help reduce the transition effort once Equifax
starts to return future use fields in the response.
Refer to section 6.2.3.2.5.2 Accounts Seq 2.1.5.3.1.23 additional data fields and 8.29 Term of Loan Unit Type code
table for a list of valid values.
33
The following areas will be of particular interest to users of previous VedaScore XML-based products:
● Authentication: API Connect SOAP relies on the WS-Security protocol for handling user credentials as part
of the transaction.
● Dedicated SOAP Endpoint: The API Connect SOAP channel provides separate, dedicated SOAP/HTTP
endpoints for each product suite, including one shared between Equifax Apply and Equifax Commercial
Apply.
Whereas previous VedaScore products supported only a synchronous transmission model, Equifax Apply and
Equifax Commercial Apply are typically invoked using a hybrid mode of operation, which aims to provide a
complete response in real-time but with the possibility to switch to an asynchronous model if required. A fully
asynchronous mode of operation is also supported by this specific product. Both modes of operations are
described in the sections below.
By default, each transaction starts with the aim of completing the request in real-time but switches automatically
to asynchronous alternative mode under circumstances where the system is unable to fulfil the request within the
service response window.
When switching to this alternative mode, the initial transaction will return a ticket response rather than a product
report. This ticket will provide a unique enquiry identifier which can be used to retrieve the completed product
report at a later time from the API Connect server. The diagram in Figure 1 provides a high-level view of the
semi-asynchronous transmission model.
34
Figure 1 – Hybrid Sync/Async Transmission Model
Note that the API does not at this stage support a PUSH delivery model and the caller must therefore explicitly
initiate the subsequent transaction with the API Connect server to PULL the completed report (NB: client polling
mechanisms should follow Equifax recommendations when checking for completed reports). The diagram in
Figure 2 describes a typical sequence of events when requesting an Equifax Apply or an Equifax Commercial
Apply report using the asynchronous API.
35
Figure 2 - Asynchronous Transmission Model
36
Figure 3 - Polling for a completed report
The following guidelines may be used to assist in the decision of which integration API to use.
37
4.1.5.1 Typical Synchronous/Hybrid Use-cases
● End users require or expect a response in near-real-time, as part of the credit origination process
● The client system has limited or no capability to integrate with a ticketing system (in which case ticketing
scenarios made possible by the hybrid API may be treated as exceptions)
● There is a need or preference for keeping the number of HTTP POST calls per enquiry to a minimum (most
hybrid transactions will typically only require a single POST)
4.1.5.2 Typical Asynchronous Use-cases
● The user consuming the report is not the same person who submitted the enquiry
● The credit origination workflow does not require an immediate response to the initial enquiry
● The client system has built-in capabilities for integration which lend themselves to asynchronous
processing
● There is a need to submit enquiries in small batches and do not require to return an immediate response
for each to a user
4.3 Enquiry ID
The enquiry ID is used to uniquely identify a particular business transaction, such as an Equifax Apply enquiry or
an Equifax Commercial Apply enquiry. It is always returned in the response (as part of the product-header) in both
synchronous or asynchronous models and can thereafter be used to retrieve the corresponding report, using the
web service operations dedicated to that purpose (see section 5.1 - Operations).
It is also of value within the context of troubleshooting and support queries, where Equifax support personnel can
use this number to rapidly identify and isolate events pertaining to a particular enquiry.
4.4 Timeouts
The recommended HTTP timeout for Equifax Apply and Equifax Commercial Apply will be specified in a later
iteration of this document. In general terms, Equifax typically recommends a minimum value of 45 seconds for
connection timeouts.
38
4.5 Supported SOAP Bindings
The Equifax Apply WSDL may show bindings for SOAP version 1.1 and 1.2. It should be noted that only SOAP 1.1 is
currently supported. Support for SOAP 1.2 may be introduced in a later release (based on demand).
API Connect responses return apostrophes and quotation marks as their original characters; they are not
transformed to XML references. Angle brackets and the ampersand character are transformed to their
XML reference.
4.7.1 Overview
Requests are validated in two stages:
● Initial validation takes place when the request is parsed by the schema. This validation focuses on the
structure and the request message, with some basic type-checking. Errors encountered during schema
validation will typically abort the transaction and return a SOAP fault.
● Further validation takes place after Equifax has received the request and has successfully validated it
against the schema. This validation checks the items that the schema was unable to validate, for instance,
validating field data against known product business rules. Errors will be returned as product errors.
Refer to section 4.8 - Error-handling for more information on error-handling for this product.
39
4.7.2 Validating addresses
Formatted addresses divide the address into specific items, such as the street name and the suburb name. Equifax
recommends the use of formatted addresses wherever possible for optimum matching.
4.7.2.1 Formatted addresses
In the case of formatted addresses, different elements may be mandatory, depending on the composition of the
address.
For example, this address uses a street number/street name combination:
<street-number>8</street-number>
<street-name>Taree</street-name>
<street-type >AVE</street-type >
<property>The Gables</property>
<street-name>The Avenue</street-name>
<street-name>The</street-name>
<street-type >AVE</street-type >
If a street type does not match any of the street-type codes listed in the Product Guide, do not enter it.
Australian addresses require a suburb/state combination in an address.
4.7.2.2 Unformatted addresses
Where a fully fielded address is not available, the Equifax Apply schema also provides support for unformatted
addresses. Where possible and applicable (i.e. for addresses in Australia), unformatted addresses should be
entered using a structure in line, as per the following example:
<unformatted-address>The Gables 8 Taree AVE North Balgowlah NSW 2093</ unformatted-address >
40
4.8 Error-handling
Equifax Apply implements error-handling in a manner that is consistent with the approach described in the API
Connect Connectivity Guide. Error message formats will vary, depending on the type and cause of the error.
System-level or transport-level errors, such as protocol or authentication errors, are returned to the caller as SOAP
Faults and should be handled accordingly by the client. The following is an example of a failed authentication
attempt to use the service.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<soapenv:Fault>
<faultcode>soapenv:Server</faultcode>
<faultstring>Policy Falsified</faultstring>
<faultactor>http://127.0.0.1:8080/sys2/ping-v1</faultactor>
<detail>
<l7:policyResult status="Authentication Failed"
xmlns:l7="http://www.layer7tech.com/ws/policy/fault"/>
</detail>
</soapenv:Fault>
</soapenv:Body>
</soapenv:Envelope>
For more information on this type of error, including more examples, please refer to the API Connect Connectivity
Guide.
Product-type errors, which for instance result from an incorrect or invalid use of the product, are returned to the
caller as error messages inside a valid SOAP response body.
Refer to 7.2 Product error codes and descriptions for a categorisation of error codes and recommended action(s)
relevant to this product.
Equifax provides a dedicated test environment to subscribers to enable them to test their solution prior to
deployment in a production environment. This environment offers a test service endpoint for both connectivity
and functional testing to assist software developers in integrating with Equifax Apply. The test service endpoint
enables subscribers to test the full array of functionality by submitting enquiries against a test system and receive
dynamically generated responses in return.
Refer to the Equifax Apply and Equifax Commercial Apply – Customer Test Guide for an understanding of which
features, and test cases are available in this environment
Refer to section 5.2 - Endpoint URLs for more information on how to connect to the product endpoint in CTE.
41
5 Web Services
5.1 Operations
The table below contains a list of services specific to the Equifax Apply and Equifax Commercial Apply products
and a brief description for each service. Detailed description for each service can be found in subsequent
chapters.
Service Description
submitEnquiry
This web-service operation allows users to perform a credit application enquiry by
using either an Equifax reference (identified as bureau-reference in the schema) or
searching using the applicant's personal details and details of the credit for which
the applicant has applied for.
This operation is expected to return the applicant's credit information within the
agreed response time. If that is not possible, it will instead only return the Enquiry
ID for the requester to use to retrieve the credit information at a later time.
submitEnquiryAsync Same as submitEnquiry; however, the interaction is asynchronously fulfilled.
This web-service operation will return an EnquiryID for which the user will be able
to retrieve the applicant's individual Consumer credit information later by using the
Enquiry ID as input into the retrieveEnquiryByID operation.
retrieveEnquiryByID This web service allows the user to retrieve a previously requested enquiry.
To use this operation, the serviced consumer must provide an Enquiry ID that is
typically acquired from calling one of the previous operations.
Details of each operation are provided in the next sections by way of request and response message
specifications. The intent is to explain the semantics of the data being exchanged in each message and associated
business rules, over and above to the information available in the WSDL files.
The message specifications include the schemas, represented diagrammatically (one high level diagram followed
by the low-level diagrams for complex elements), and the list of elements for each message.
42
6 Request & Response Message Specifications
6.1 Conventions
: indicates a choice.
43
● Format and Validation Rules: Describes the format and or validation rule applicable to the data element.
1. submitEnquiry
2. submitEnquiryAsync
These web service operations allow the user to search the Equifax database(s) for an individual’s (i.e. the credit applicant’s) credit information.
To increase the possibility that the database finds the correct individual, ensure that as much information about the individual is supplied as possible.
If a field is optional and the intention is to not supply a value, then do not submit the element tags at all. <element></element> or
<element/> are interpreted as a zero length string and will be subject to field and cross field validation rules if supplied.
This principle is applicable to future use fields also. Whilst a field is marked as future use, such fields should not be submitted in the request
to avoid additional and unnecessary validation. Future use fields have no bearing on the report until they are enabled.
44
o Product Data level; Data level must be compatible with the requestor subscriber’s Comprehensive Reporting data contribution level.
o Requested scores; can include more than one score. Scorecard ID(s) must be compatible with the requested product data level.
● Enquiry data information
o Credit applicant’s identification details; Bureau reference or personal details.
o Details of the line of credit for which the applicant is applying for.
The following illustration depicts the general structure of the request.
Figure 5: Enquiry-header
45
Message Body Content Table
Seq XML Element Type O/C Description Len V/F Format and Validation Rules
No
1 enquiry-header Container 1 Container for control information related to the
request.
1.1 client-reference Element 0-1 Client reference ID provided associated with this 64 V Valid characters are Alphanumeric,
request transaction – this value will be returned Blanks, and the following characters:
back in response for traceability. @#$%&*()-_+=!\}{“‘?/.,:;
1.2 operator-id Element 0-1 Operator (or system) identifier submitting this 20 V
request transaction N
1.3 operator-name Element 0-1 Operator name submitting this request 20 V
transaction – this value will be returned back in
response for traceability.
1.4 permission-type-code Element 1 Indicates the permission type. Used to 2 V Refer to 2.2 - Permission type for
determine whether consumer and/or more information about permission
commercial data is included in the report. type.
1.5 product-data-level-code Element 1 Indicates the product data level used to 1 F Refer to 8.6 - Data Level code table (p.)
construct the report. for valid values
For Credit Providers, this value must be less than
or equal to the Credit Provider's data
contribution level with Equifax.
For Access Seekers, this value must be set to C
(Comprehensive).
For Telcos, this value must be less than or equal
to the data contribution level with Equifax
(Negative/ Partial).
For Utility and Alternative Lending customers,
this value must be set to N (Negative). Partial (for
Utilities) and Comprehensive (for Alternative
Lending) data level is not currently available.
1.6 requested-scores Container 0-1 Contains the scorecard ID of the primary score
and additional scores if requested.
1.6.1 scorecard-id Element 0-M Scorecard Identifier -Indicates the scorecard to 20 V Note: When no scorecard ID is
return in the product response. Must be a specified, the system uses the latest
46
compatible scorecard to the product and product scorecard based on permission type
data level. and data level.
Telco, Utility, or Alternative Lending
Scorecard ID is mandatory for Equifax
Apply (Telco), Equifax Apply (Utility)
and Equifax Apply (Alternative Lending)
products.
1.7 possible-matches Container 0-1 Future use only
1.7.1 maximum-matches Element 1 Future use only
1.7.2 match-criteria Container 1-M Future use only
1.7.2.1 match-criterion Element 1 Future use only
1.8 custom-input-parameters Container 0-1 List of custom input parameters to specify
additional product variations.
1.8.1 custom-input-parameter Element 1-M Contains a key/value pair for a custom
parameter.
1.8.1.1 Key Element 1 The custom input parameter key. V String,
To order Individual Trading History
Summary add “ITH” here.
Note: There is no validation of this field.
If the key matches to a known custom
input parameter then it is processed,
else it is ignored.
1.8.1.2 value Element 1 The custom input parameter value. V String.
To order Individual Trading History
Summary add “true” here.
47
6.2.2.2 Bureau-reference and Individual
Schema location: request>enquiry-data>individual
request>enquiry-data>bureau-reference
48
2.2 individual Container 0-1 Contains personal detail elements for If details in individual container are entered, then
identifying an individual. Use this option if bureau-reference must not be supplied.
searching by identification data of that
individual.
To increase the possibility that the search
finds the correct individual, submit as much
personal information about that individual
as possible.
2.2.1 current-name Container 1 Contains the individual's name elements. Mandatory if individual is present.
2.2.1.1 title Element 0-1 Future use only 25 V
2.2.1.2 family-name Element 1 Family Name. Also referred to as Surname. 50 V Max 50 chars.
Min 1 char.
If the applicant only has a single name Valid characters are Alpha, Blanks, Hyphens and
being their first-given-name, then Apostrophes. Exception for forward slash in the
family-name is to be reported as ‘N/A’ to case of ‘N/A’ (not case sensitive).
indicate not applicable. First character must be Alpha or Apostrophe.
Blanks, Hyphens and Apostrophes must not be
adjacent.
If family-name is 1 character, that character must
be Alpha.
family-name and first-given-name cannot both be
‘N/A’.
Refer to 4.6 Reserved XML characters for more
details.
2.2.1.3 first-given-name Element 1 First Name. 40 V Max 40 chars.
Min 1 chars
If the applicant only has a single name Valid characters are Alpha, Blanks, Hyphens and
being their family-name, then Apostrophes. Exception for forward slash in the
first-given-name is to be reported as ‘N/A’ case of ‘N/A’ (not case sensitive).
to indicate not applicable. First character must be Alpha.
Blanks, Hyphens and Apostrophes must not be
adjacent.
first-given-name and family-name cannot both be
‘N/A’.
Refer to 4.6 Reserved XML characters for more
details.
49
2.2.1.4 other-given-name Element 0-1 Also referred to as middle names. 80 V Max 80 chars.
Although optional this information is Min 1 char.
recommended for better file matching. Valid characters are Alpha, Blanks, Hyphens and
Apostrophes.
First character must be Alpha.
Blanks, Hyphens and Apostrophes must not be
adjacent.
Refer to Appendix A –Tips for Matching to
Individual Bureau Files
Refer to 4.6 Reserved XML characters for more
details.
2.2.2 known-as-names Container 0-1 Future use only
2.2.2.1 known-as Container 1-M Future use only
2.2.1.1.1 title Element 0-1 Future use only 25 V
2.2.2.1.2 family-name Element 1 Future use only 50 V
2.2.2.1.3 first-given-name Element 1 Future use only 40 V
2.2.2.1.4 other-given-name Element 0-1 Future use only 80 V
2.2.3 previous-names Container 0-1 Future use only
2.2.3.1 previous-name Container 1-M Future use only
2.2.3.1.1 title Element 0-1 Future use only 25 V
2.2.3.1.2 family-name Element 1 Future use only 50 V
2.2.3.1.3 first-given-name Element 1 Future use only 40 V
2.2.3.1.4 other-given-name Element 0-1 Future use only 80 V
2.2.4 addresses Container 1 Contains information about the individual's
address.
2.2.4.1 address Container 1-M Contains information about an instance of There can be up to two addresses: one for the
the individual's address. current and one for the previous address. Note
that previous address is optional but
recommended - refer to Appendix A –Tips for
Matching to Individual Bureau Files
Customers have the choice of submitting a
formatted address or unformatted address.
2.2.4.1.1 @type Attribute 1 Address type. 1 F Refer to 8.1 - Address Type code table (p.) for valid
values.
Refer to Appendix A –Tips for Matching to
Individual Bureau Files
2.2.4.1.2 @time-at-address Attribute 0-1 Future use only
50
2.2.4.1.3 property Element 0-1 Property Name 40 V Max 40 chars.
Min 3 chars.
This field is required if street-name is not entered.
Valid characters are Alpha, Numeric, Blanks,
Hyphen, Apostrophe, Slash and Back Slash.
Blank, Hyphen, Apostrophe, Slash and Back Slash
cannot be adjacent.
Refer to 4.6 Reserved XML characters for more
details.
2.2.4.1.4 unit-number Element 0-1 Unit or Flat Number 5 V Noise words such as ‘UNIT’, ‘FLAT’, ‘NO.’ etc.
should not be included in this field when supplied.
Max 5 chars.
Min 1 char.
Valid characters are Alpha, Numeric, Blanks,
Hyphen, Slash and Back Slash.
Blank, Hyphen, Slash and Back Slash cannot be
adjacent.
2.2.4.1.5 street-number Element 0-1 Street/House Number 8 V If the address legitimately does not have a street
number and Street Name has been input then
‘N/A’ must be input for Street Number to indicate
not applicable
If this field is entered, then there must also be a
street-name. Should start with a numeric value.
e.g.: ’56 Lot’
Max 8 chars.
Min 1 char.
Valid characters are Alpha, Numeric, Blank,
Hyphen, Slash and Back Slash.
Blanks, Hyphen, Slash and Back Slash cannot be
adjacent.
51
2.2.4.1.6 street-name Element 0-1 Street Name 40 V This field is required if property is not entered.
If this field is entered, then there must also be a
street-number.
Max 40 chars.
Min1 char.
Valid characters are Alpha, Numeric Blanks,
Hyphen, Apostrophe, Slash and Back Slash.
Blanks, Hyphen, Slash and Back Slash cannot be
adjacent.
Refer to 4.6 Reserved XML characters for more
details.
2.2.4.1.7 street-type Element 0-1 Street Type 4 V If this field is entered, then there must also be a
street-name.
52
For other overseas addresses, use 'OS' in the state
field.
2.2.4.1.1 dpid Element 0-1 Future use only 8 F
2
2.2.4.1.1 unformatted-addres Element 0-1 Free-form Address. 340 V An unformatted address must contain at least a
3 s street name or property name, suburb, state
Must contain a minimum set of Address code.
data elements to identify a valid unique Max 340 chars.
address. Min 10 chars.
If possible enclose the property name within
quotation marks. This will increase the chances of
the system decoding the address.
Refer to 4.6 Reserved XML characters for more
details.
2.2.5 drivers-licence Container 0-1 Contains information about the individual's Refer to Appendix A –Tips for Matching to
driver's licence. Individual Bureau Files
Refer to Appendix B –Tips for entering Driver
Licence Number
2.2.5.1 country-code Element 0-1 Future use only 3 V
2.2.5.2 number Element 1 Drivers Licence number 9 V Must be a valid Driver’s Licence number as issued
by the relevant State authority.
Max 9 chars.
Min 4 chars.
53
2.2.8 employment Container 0-1 Contains information about the individual's Refer to Appendix A –Tips for Matching to
employment. Individual Bureau Files
2.2.8 employer Container 1-M Contains information about the individual's Only one employer record can be submitted in the
employer. request; current employer record. Previous
employer is not currently supported.
2.2.8.1 @type Attribute 1 Employment type 1 F Refer to 8.9 Employment Type code table for valid
values
2.2.8.2 name Element 1 Name of Employer 100 V Minimum length of 2 chars.
Valid characters are Alphanumeric, Blanks, and
the following characters: @ # $ % & * ( ) - _ + = ! \
}{“‘?/.,:;
Blanks, hyphens, commas and semicolons cannot
be adjacent. Apostrophe cannot be the ending
value.
Note: For Self-employed individuals use ‘SELF
EMPLOYED’ or ‘SELF’.
Refer to 4.6 Reserved XML characters for more
details.
2.2.8.3 country-code Element 0-1 Future use only 3 V
2.2.8.4 ABN Element 0-1 Future use only 11 F
2.2.8.5 organisation-numbe Element 0-1 Future use only 9 F
r
2.2.8.6 occupation Element 0-1 Free-form occupation description. 22 V Max 22 chars.
Applicable only if the credit purpose is for Min 1 char.
individual Commercial Credit. Valid characters are Alpha, Numeric, Blanks,
Commas and Semicolons.
Blanks, commas and semicolons cannot be
adjacent.
Note: For Self-employed individuals leave this
field blank
Refer to 4.6 Reserved XML characters for more
details.
2.2.8.7 is-self-employed Element 0-1 Future use only 5 V
54
6.2.2.3 Enquiry
Schema location: request>enquiry-data>enquiry
Figure 7: Enquiry
55
Please note this field remains
mandatory for all Credit Provider,
Telco, Utility, Alternative Lending and
Access Seeker enquiries.
2.3.3 enquiry-amount Element 0-1 Amount of credit applied for. 9 V Maximum length of 9 chars. Enter
whole dollars only, without a decimal
place or separators.
Please note this field remains
mandatory for all Credit Provider,
Telco, Utility, Alternative Lending and
Access Seeker enquiries.
2.3.3.1 @currency-code Attribute 0-1 Indicates the type of currency. Currency code must 3 F The only currency supported at this
conform to the ISO 4217 standard. stage is AUD.
Defaults to AUD if not supplied.
2.3.4 is-credit-review Element 0-1 Indicates whether the enquiry is in relation to a review 5 V Valid values are ‘true’ or ‘false’.
of an existing commercial account or a credit limit
increase. Note: This element is ignored if the
permission type is Consumer (X) or
If the enquiry is a Commercial or Consumer+Commercial (XY).
Commercial+Consumer enquiry, then the purpose of
the enquiry can be a credit review rather than a new
credit application. If this is the case submit a value of
‘true’ in this element.
56
2.3.8 co-borrower Element 0-1 Name of co-borrower if the individual is not a single 20 V
Max 20 chars.
borrower (in free-form text).
Applicable only if the credit purpose is individual Min 2 chars.
Commercial Credit.
Valid characters are Alphanumeric,
Blanks, and the following characters:
@#$%&*()-_+=!\}{“‘?/.,:;
Blanks, hyphens, commas and
semicolons cannot be adjacent.
Ampersand must be suffixed by Blank.
2.3.9 enquiry-client-reference Element 0-1 Client enquiry reference associated to this credit 15 V
Max 15 chars.
enquiry application such as a client number or account
number. This enquiry client reference is stored on the Min 1 char.
Equifax bureau and is returned to all subsequent
Valid characters are Alphanumeric,
enquirers on the individuals file.
Blanks, and the following characters:
@#$%&*()-_+=!\}{“‘?/,.:;
Must contain at least one numeric
character.
2.3.10 other-enquiry-attribute Containe 0-1 Future use only - -
s r
2.3.10.1 enquiry-attribute Element 1- Future use only
M
2.3.10.1. key Element 1 Future use only
1
2.3.10.1. value Element 1 Future use only
2
2.3.10.1. @unit Attribute 0-1 Future use only
3
57
6.2.3 Response Overview
The response returned to a new enquiry request depends on the transmission mode chosen (synchronous/asynchronous) as well as the system’s capacity to
fulfil the request within the service response window.
The system will return a response to the one described in 6.2.3.1 Ticket Response in the following scenarios:
● The request was submitted using the asynchronous operation
● The request was submitted using the synchronous operation but was not fulfilled within the service response window.
The system will return a response to the one described in 6.2.3.2 Report Response in all other cases, where no system errors occurred.
The following illustration depicts the general structure of the ticket response.
58
Figure 8: Ticket Response Overview
Message Body Content Table
Seq No XML Element Type O/C Description
0 @response-type Attribute 0-1 Describes the nature of the response. For a ticket response, possible values are “ticket” or “error”.
1 product-header Container 0-1 Container for control information related to the response.
Child XML elements of this container element are defined under 6.2.3.1.1 Product-header
3 general-messages Container 0-1 Container for general messages related to the response. It does not relate to a specific element or file.
Child XML elements of this container element are defined under 6.2.3.1.2 General Messages
4 errors Container 0-1 Container for errors related to the response.
Child XML elements of this container element are defined under 6.2.3.1.3 Errors
59
6.2.3.1.1 Product-header
Schema location: ticket-response>product -header
response>product -header
Figure 9: Product-header
Message Body Content Table
Seq No XML Element Type O/C Description Len V/F Format and
Validation Rules
1 product-header Container 0-1 Container for control information related to the response.
1.1 enquiry-id Element 1 System generated unique ID related to this response 20 V
transaction. This ID can be used to retrieve this response at a
later time.
1.2 datetime-requested Element 1 Date and time of request. 29 F CCYY-MM-DDThh:m
m:ss.sss(+|-)hh:mm
60
1.3 datetime-generated Element 0-1 Date and time of response 29 F CCYY-MM-DDThh:m
m:ss.sss(+|-)hh:mm
1.4 client-reference Element 0-1 Client reference ID supplied in the request message. 64 V
1.5 operator-id Element 0-1 Operator (or system) identifier who submitted this request 20 V
transaction supplied in the request message.
1.6 operator-name Element 0-1 Operator name who submitted this request transaction 20 V
supplied in the request message.
1.7 product-name Element 1 Product Name. 50 V Defined by service
end-point and
If permission type is X (Consumer) or XY permission type.
(Consumer+Commercial), the product name will be .
VedaScore Apply®, unless Equifax One Score has been
requested, then it will show: “Equifax Apply One Score”
If permission type YX (Commercial + Consumer) or
Y(Commercial), the product name will be Commercial Credit
Assess - Individual.
1.8 permission-type Element 1 Permission Type. Defined by the permission-type code 40 V
supplied in the request message.
1.8.1 @code Attribute 0-1 Code associated with the permission type 2 F Refer to 8.15
Permission Type code
table for valid values
1.9 product-data-level Element 0-1 Indicates the product data level used to construct the report. 20 V
This value was selected from the request.
1.9.1 @code Attribute 0-1 Code associated with the product data level 1 F Refer to 8.6 Data
Level table for valid
values
1.10 product-version Element 0-1 Product Version. Defined by service end-point. 5 V
1.11 possible-matches Container 0-1 Future use only
1.11.1 maximum-matches Element 0-1 Future use only 2 V
1.11.2 match-criteria Container 0-1 Future use only
1.11.2.1 match-criterion Element 1- Future use only 2 V
M
1.12 custom-input-parameters Container 0-1 Future use only
1.12.1 custom-input-parameter Container 1- Future use only 20 V
M
1.12.1.1 key Element 1 Future use only 20 V
1.12.1.2 value Element 1 Future use only 20 V
61
1.12.1.2.1 @unit Attribute 0-1 Future use only 20 V
1.13 configuration-data-attributes Container 0-1 Contains client configuration as key and value pairs - Sourced
from configuration for that client.
1.13.1 configuration-data-attribute Container 1- Configuration parameter that has been applied to the
M requested product.
1.13.1.1 key Element 1 The key associated with the configuration parameter. 20 V
1.13.1.2 value Element 1 The value associated with the configuration parameter. 20 V
1.13.1.2.1 @unit Attribute 0-1 Unit of measurement associated with the value. 20 V
6.2.3.1.2 General-messages
Schema location: ticket-response>general-messages
response>general-messages
62
6.2.3.1.3 Errors
Schema location: ticket-response>errors
response>errors
63
6.2.3.2 Report Response
Schema location: response>product-data
If the request enquiry was performed by Bureau Reference, the system will return the individual explicitly identified by this reference. Otherwise, if the
request was performed by searching by identity details, the system will find the best match to that information. See 7.1 Responses to matching of
identification data from the request (p. 111) for more information.
Possible matches may be returned if the information partially matches the request identity details.
If a File Ban is active on that individual’s records, then a file ban report is returned rather than an enquiry report.
Response includes:
● Product header information; contains the unique enquiry ID and a range of other report metadata. The data in this message component sets the
parameters that conditioned the report. This could be from the requested or configuration driven.
● Product data information
o File ban report; this is returned when the individual’s records are under a File Ban.
o Enquiry report
▪ Identity data and aliases; discloses the individual’s personal details from the primary match and alias identity files with FIR
● Consumer credit file; sourced from the individual Consumer database and contains credit enquiry data, account data
including default, repayment history data, financial hardship information and messages.
● Commercial credit file; sourced from the individual Commercial database and contains credit enquiry data, account data
including default and repayment history data, messages and file notes.
● Public record or Consumer credit information; sourced from public sources, contains court actions, directorships, business
names, insolvencies and messages. Notwithstanding the fact that this data is sourced from the Public domain, this
information is Consumer credit information under the Act when the credit purpose is for Consumer credit and should be
treated as such.
▪ Summary data; derived summary data about the individual’s credit file across the data across the individual Consumer, individual
Commercial (if applicable) and Public sources. This data can be used in the Decisioning process in addition to scores.
▪ Score data; depending on the request, multiple scores can be returned. All scores are accompanied by key contributing factors.
o Possible matches; can be returned if the information partially matches the request identity details. A search on the possible match identity
can be performed by a subsequent enquiry using the Bureau reference as input.
● General messages; relate to the response in general as opposed to a specific element or file. E.g. a statutory disclaimer to qualify circumstances
under which the report was generated.
64
● Errors; such errors are not system errors but report build errors. They are valid use case scenarios. The information returned in this message
component can help describe and locate the root of the report build error for investigation.
The following illustration depicts the general structure of the report response.
65
0 @response-type Attribute 0-1 Describes the nature of the response. For a report response, possible values are “ticket”, “report”,
“file-ban” or “error”.
1 product-header Container 0-1 Container for control information related to the response.
Child XML elements of this container element are defined under 6.2.3.1.1 Product-header.
2 product-data Container 0-1 Container for response information related to the enquiry.
2.1 enquiry-report Container 0-1 Contains information about the individual's personal information, credit and public data found in the
Equifax databases.
2.1.1 primary-match Container 1 Contains the individual's personal information from the primary match record.
Child XML elements of this container element are defined under 6.2.3.2.1-Primary-match.
2.1.2 other-identities Container 0-1 Contains the individual's personal information from any alias identity files. An individual may have
many aliases.
Child XML elements of this container element are defined under 6.2.3.2.2-Other-identities.
2.1.3 addresses Container 0-1 Contains information about the individual's addresses.
Child XML elements of this container element are defined under 6.2.3.2.3 Addresses.
2.1.4 employment Container 0-1 Contains information about the individual's employment.
Child XML elements of this container element are defined under 6.2.3.2.4-Employment
2.1.5 consumer-credit-file Container 0-1 Child XML elements of this container element are defined under 6.2.3.2.5-Consumer-credit-file
2.1.6 commercial-credit-file Container 0-1 Commercial data is included only if the permission type specified in the request includes commercial
data
Child XML elements of this container element are defined under 6.2.3.2.6 - Commercial-credit-file
2.1.7 public-record-or-consumer-c Container 0-1 In the context of a consumer enquiry, this section includes consumer credit information.
redit-information In the context of a commercial enquiry, this section includes public records.
Child XML elements of this container element are defined under 6.2.3.2.7 - Public-record or
consumer-credit-information
2.2 file-ban-report Container 0-1 Indicates whether the individual is under a Ban. If the individual is under a Ban then the
enquiry-report element will not be returned. Mutually exclusive. Ban Flags are a requirement under
the Privacy Act.
Child XML elements of this container element are defined under 6.2.3.6 -File-ban-report
2.3 summary-data Container 0-1 Contains summarised information about the individual's credit file data which are called
characteristics.
Child XML elements of this container element are defined under 6.2.3.3-Summary-data
2.4 score-data Container 0-1 Contains information about the individual's scores. The response may include multiple scores if
additional score cards were requested.
Child XML elements of this container element are defined under 6.2.3.4-Score-data
2.5 possible-matches Container 0-1 Contains personal information of possible match files to the individual. An individual may have many
possible matches.
Child XML elements of this container element are defined under 6.2.3.5-Possible-matches
3 general-messages Container 0-1 Container for general messages related to the response. It does not relate to a specific element or file.
66
Child XML elements of this container element are defined under 6.2.3.1.2 General Messages
4 errors Container 0-1 Container for errors related to the response.
Child XML elements of this container element are defined under 6.2.3.1.3 Errors
6.2.3.2.1 Primary-match
Schema location: response>product-data>enquiry-report>primary-match
Seq No XML Element Type O/C Description Len V/F Format and Validation
Rules
2.1.1 primary-match Container 1 Contains the individual's personal information from the primary
match record.
2.1.1.1 @id-index Attribute 0-1 An identifier appended to each known identity of the individual. 3 V
Information relating to the individual (credit enquiry, account,
67
bankruptcy…) can include a reference to this identity index
value to associate which identity the information was sourced
from. This feature is called Full Identity Reporting (FIR).
2.1.1.2 @type Attribute 0-1 For the primary match record, this value indicates if it is a 10 V
'strong' or 'create' match.
For the possible match record, this value will return ‘possible’.
2.1.1.3 @is-disputed Attribute 0-1 Future use only 5 V
2.1.1.4 @dispute-reported-date Attribute 0-1 Future use only 10 F Format ccyy-mm-dd
2.1.1.5 @dispute-code Attribute 0-1 Future use only 1 V
2.1.1.6 bureau-reference Element 0-1 Bureau reference; this is a unique identifier for that individual. 10 V Bureau reference will
only be returned in the
case for a
primary-match record
and possible-matches
records.
2.1.1.7.2 @last-reported-date Attribute 0-1 Last reported date of name in the Bureau. 10 F Format ccyy-mm-dd
(Not returned for
possible matches.)
2.1.1.7.3 @last-credit-enquiry-date Attribute 0-1 Last credit enquiry date submitted against this identity. 10 F Format ccyy-mm-dd
Depending on the credit purpose it will return the date of the (Not returned for
last consumer credit enquiry or the last commercial credit possible matches.)
enquiry.
2.1.1.7.4 title Element 0-1 Future use only 25 V
2.1.1.7.5 family-name Element 0-1 Family Name. Also referred to as Surname 50 V
68
2.1.1.7.6 first-given-name Element 0-1 First Name 40 V
2.1.1.7.7 other-given-name Element 0- Other given name. Also referred to as middle name. 80 V
M
2.1.1.8 gender Element 0-1 Gender of individual 7 V
2.1.1.8.1 code Attribute 0-1 Code associated with the gender 1 F Refer to 8.10 - Gender
code table for valid
values
2.1.1.9 date-of-birth Element 0-1 Date of birth of individual 10 F Format ccyy-mm-dd
2.1.1.9.1 @first-reported-date Attribute 0-1 First reported date of DOB to Equifax 10 F Format ccyy-mm-dd
(Not returned for
possible matches.)
2.1.1.9.2 @last-reported-date Attribute 0-1 Last reported date of DOB to Equifax. 10 F Format ccyy-mm-dd
(Not returned for
possible matches.)
2.1.1.10 drivers-licence Container 0-1 Includes driver licence details
2.1.1.10.1 @first-reported-date Attribute 0-1 First reported date of Driver’s Licence number to Equifax. 10 F Format ccyy-mm-dd
(Not returned for
possible matches.)
2.1.1.10.2 @last-reported-date Attribute 0-1 Last reported date of Driver’s Licence number to Equifax. 10 F Format ccyy-mm-dd
(Not returned for
possible matches.)
2.1.1.10.3 country-code Element 0-1 Future use only 3 V
2.1.1.10.4 state Element 0-1 Future use only 3 V
2.1.1.10.5 number Element 0-1 Drivers Licence number 9 V
2.1.1.10.6 date-of-expiry Element 0-1 Future use only 10 F Format ccyy-mm-dd
2.1.1.10.7 card-number Element 0-1 Future use only 10 V
2.1.1.11 lodged-complaint Element 0-1 Indicates whether the individual has lodged a complaint about 5 V (Not returned for
Equifax acts or practices that may be a breach of the Amending possible matches.)
Act or Credit Reporting Code.
2.1.1.11.1 @reported-date Attribute 0-1 Reported date of the Complaint. 10 F Format ccyy-mm-dd
(Not returned for
possible matches.)
2.1.1.12 is-deceased Element 0-1 5 V (Not returned for
possible matches.)
2.1.1.12.1 @reported-date Attribute 0-1 Reported date of the deceased status 10 F Format ccyy-mm-dd
(Not returned for
possible matches.)
69
2.1.1.13 do-not-provide-credit Element 0-1 Future use only 5 V
2.1.1.13.1 @reported-date Attribute 0-1 Future use only 10 F Format ccyy-mm-dd
2.1.1.14 other-indicators Container 0-1 Future use only.
2.1.1.14.1 indicator Container 1- Future use only
M
2.1.1.14.1.1 @reported-date Attribute 0-1 Future use only 10 F Format ccyy-mm-dd
2.1.1.14.1.2 key Element 1 Future use only 20 V
2.1.1.14.1.3 value Element 1 Future use only 20 V
2.1.1.14.1.3. @unit Attribute 0-1 Future use only. 20 V
1
6.2.3.2.2 Other-identities
Schema location: response>product-data>enquiry-report>other-identities
70
Message Body Content Table
Seq XML Element Type O/C Description Le V/F Format and
No n Validation Rules
2.1.2 other-identities Container 0-1 Contains the individual's personal information from any alias identity files. An
individual may have many aliases.
2.1.2.1 other-identity Container 1-50 Contains the individual's personal information an instance of an alias identity
record.
Child XML elements of this container element are defined under 6.2.3.2.1 -
Primary-match
71
6.2.3.2.3 Addresses
Schema location: response>product-data>enquiry-report>addresses
72
2.1.3.1.1 @first-reported-date Attribute 0-1 First reported date of this address from this 10 F Format ccyy-mm-dd
individual to Equifax. Not applicable to possible matches.
2.1.3.1.2 @last-reported-date Attribute 0-1 Last reported date of this address from this 10 F Format ccyy-mm-dd
individual to Equifax. Not applicable to possible matches.
2.1.3.1.3 @is-disputed Attribute 0-1 Future use only 5 V
2.1.3.1.4 @dispute-reported-date Attribute 0-1 Future use only 10 F Format ccyy-mm-dd
2.1.3.1.5 @dispute-code Attribute 0-1 Future use only 1 V
2.1.3.1.6 @type Attribute 0-1 Address type. 1 F Refer to 8.1 - Address Type code table
for valid values
2.1.3.1.7 id-references Container 0-1 Contains a list of id-references
2.1.3.1.7. id-reference Element 1-M Reference to associate the source of this 3 V
1 information to the identity defined by identity
index.
2.1.3.1.8 property Element 0-1 Property Name 40 V
2.1.3.1.9 unit-number Element 0-1 Unit or Flat Number 5 V
2.1.3.1.10 street-number Element 0-1 Street/House Number 8 V
2.1.3.1.11 street-name Element 0-1 Street Name 40 V
2.1.3.1.12 street-type Element 0-1 Street Type 4 V Refer to 8.25 -Street Type code table
for valid values
2.1.3.1.13 suburb Element 0-1 Suburb or Town 50 V
2.1.3.1.14 state Element 0-1 State Code 3 V Refer to 8.24 - State code table for
valid values.
2.1.3.1.15 postcode Element 0-1 Post Code 4 F
2.1.3.1.16 dpid Element 0-1 Future use only 8 F
2.1.3.1.17 country-code Element 0-1 Country code of the country. Must conform to the 3 V
ISO 3166 standard.
73
6.2.3.2.4 Employment
Schema location: response>product-data>enquiry-report>employment
74
2.1.4.1.5 @dispute-code Attribute 0-1 Future use only 1 V
2.1.4.1.6 @type Attribute 0-1 Employment type 1 F Refer to 8.9 - Employment Type
code table for valid values
2.1.4.1.7 id-references Container 0-1 Includes a list of id-references
2.1.4.1.7.1 id-reference Element 1-M Reference to associate the source of this information 3 V
to the identity defined by identity index.
2.1.4.1.8 name Element 0-1 Name of Employer V
100
0-1 3 V
2.1.4.1.9 country-code Element Future use only
2.1.4.1.10 ABN Element 0-1 Future use only 11 F
2.1.4.1.11 organisation-number Element 0-1 Future use only 9 F
2.1.4.1.12 occupation Element 0-1 Occupation description. 22 V
2.1.4.1.13 is-self-employed Element 0-1 Future use only 5 v
6.2.3.2.5 Consumer-credit-file
Schema location: response>product-data>enquiry-report>consumer-credit-file
75
2.1.5.3 accounts Container 0-1 Includes information about the subject's accounts.
Child XML elements of this container element are defined under 6.2.3.2.5.2- Accounts
2.1.5.4 messages Container 0-1 Includes messages in relation to this section of the report.
Child XML elements of this container element are defined under 6.2.3.2.5.3- Messages
6.2.3.2.5.1 Credit-enquiries
Schema location: response>product-data>enquiry-report>consumer-credit-file>credit-enquiries
response>product-data>enquiry-report>commercial-credit-file>credit-enquiries
76
Seq No XML Element Type O/C Description Len V/F Format and Validation Rules
2.1.5.2 credit-enquiries Container 0-1 Includes information about credit-enquiries
(commercial only), credit applications
(consumer only) and authorised agent
enquiries (commercial only)
2.1.5.2.1 credit-enquiry Container 1-5 Includes details of one enquiry
0
2.1.5.2.1.1 @is-disputed Attribute 0-1 Future use only 5 V
2.1.5.2.1.2 @dispute-reported-date Attribute 0-1 Future use only 10 F Format ccyy-mm-dd
2.1.5.2.1.3 @dispute-code Attribute 0-1 Future use only 1 V
2.1.5.2.1.4 @type Attribute 0-1 Type of enquiry: credit-enquiry (commercial 24 V Refer to 8.5 - Credit enquiry type
only), credit-review (commercial only), table for valid values
credit-application (consumer only) or
authorised-agent-enquiry (commercial only)
2.1.5.2.1.5 @enquiry-date Attribute 0-1 Date the credit enquiry was recorded 10 F Format ccyy-mm-dd
2.1.5.2.1.6 id-references Container 0-1 Includes a list of id-references
2.1.5.2.1.6.1 id-reference Element 1- Reference to associate the source of this 3 V
M information to the identity defined by
identity index.
2.1.5.2.1.7 account-type Element 0-1 Type of account (descriptor) 35 V Refer to 8.2 - Consumer Account
Type for credit applications
(consumer) and consumer
authorised agent enquiries
(commercial only).
77
2.1.5.2.1.11 relationship Element 0-1 Indicates whether the subject was a single 30 V
borrower or a guarantor. Replaces the field
"role" in VedaScore 1.1.
2.1.5.2.1.11.1 @code Attribute 0-1 Type of relationship (code) 1 F Refer to 8.18 - Relationship code
table for valid values
2.1.5.2.1.12 co-borrower Element 0-1 Name of the co-borrower if the subject was 40 V Not included for consumer enquiries.
part of an association. Not applicable to commercial
enquiries if relationship is Principal
2.1.5.2.1.13 credit-enquirer Container 0-1 Includes details about who recorded the
enquiry
2.1.5.2.1.13.1 name Element 0-1 Credit enquirer name 28 V
2.1.5.2.1.13.2 classification Element 0-1 Credit enquirer’s industry type code 50 V Refer to 8.27 - Industry Classification
code table for list of codes and
description
2.1.5.2.1.14 enquiry-client-reference Element 0-1 The reference provided by the credit enquirer 15 V
2.1.5.2.1.15 additional-data-fields Container 0-1 Contains additional data fields. Will be used
in the future to report additional
information.
2.1.5.2.1.15.1 data-field Container 1- Future use only V
M
2.1.5.2.1.15.1.1 key Element 1 Future use only 20 V
2.1.5.2.1.15.1.2 value Element 1 Future use only 20 V
2.1.5.2.1.15.1.2. @unit Attribute 0-1 Future use only 20 V
1
78
6.2.3.2.5.2 Accounts
Schema location: response>product-data>enquiry-report>consumer-credit-file>accounts
response>product-data>enquiry-report>commercial-credit-file>accounts
79
Message Body Content Table
Seq No XML Element Type O/C Description Len V/F Format and Validation Rules
2.1.5.3 accounts Container 0-1 Includes information about the
subject's accounts.
2.1.5.3.1 account Container 1-10 Contains information about an instance
0 of the individual's accounts
2.1.5.3.1.1 @is-disputed Attribute 0-1 Future use only 5 V
2.1.5.3.1.2 @dispute-reported-date Attribute 0-1 Future use only 10 F Format ccyy-mm-dd
2.1.5.3.1.3 @dispute-code Attribute 0-1 Future use only 1 V
2.1.5.3.1.4 @latest-update-date Attribute 0-1 Date the account was last updated 10 F Format ccyy-mm-dd
2.1.5.3.1.5 @account-data-level Attribute 0-1 Indicates the maximum data level that 1 F Refer to 3.2.2 - Account data level
can be returned for this account. for more details and valid values
2.1.5.3.1.6 id-references Container 0-1 Includes a list of id-references
2.1.5.3.1.6.1 id-reference Element 1-M Reference to associate the source of 3 V
this information to the identity defined
by identity index.
2.1.5.3.1.7 account-id Element 0-1 Account identifier 45 V
2.1.5.3.1.8 original-credit-provider Container 0-1 Includes details about the original
credit provider
2.1.5.3.1.8.1 name Element 0-1 Original credit provider name 28 V
2.1.5.3.1.8.2 classification Element 0-1 Original credit provider’s industry type 50 V Refer to 8.27 - Industry
code Classification code table for list
of codes and description
2.1.5.3.1.8.3 is-licensee Element 0-1 Indicates whether the original credit 5 V Boolean (true/false)
provider is a licensee
2.1.5.3.1.9 latest-credit-provider Container 0-1 Includes details about the latest credit
provider
2.1.5.3.1.9.1 name Element 0-1 Latest credit provider name 28 V
2.1.5.3.1.9.2 classification Element 0-1 Latest credit provider ‘s industry type 50 V Refer to 8.27 - Industry
code Classification code table for list
of codes and description
2.1.5.3.1.9.3 is-licensee Element 0-1 Indicates whether the original credit 5 V
provider is a licensee
2.1.5.3.1.9.4 transfer-date Element 0-1 Date Account ownership was 10 F Format ccyy-mm-dd
transferred. Start of effective ownership
of account.
80
2.1.5.3.1.9.5 transfer-reason Element 0-1 Reason Account ownership was 50 V
transferred.
2.1.5.3.1.9.5.1 @code Attribute 0-1 Reason code for Account ownership 1 F Refer to 8.28 Transfer Reason
transfer code table for valid values.
81
2.1.5.3.1.18 secured-credit Element 0-1 Indicates whether a secured or 40 V
unsecured line of credit
2.1.5.3.1.18.1 @code Attribute 0-1 Code used for secured credit 1 F Refer to 8.23 - Secured Credit
code table for valid values
2.1.5.3.1.19 term-of-loan Element 0-1 The time period of the original 3 V Format NNN
contracted term of the loan Must be between 001 and 999 or
else ‘XXX’ if Ongoing or
Unspecified
Default in Months subject to
optional value supplied in
term-unit-type-value
2.1.5.3.1.23.1.2
2.1.5.3.1.20 original-maximum-amount-cre Element 0-1 Original maximum amount of credit 9 V Positive, whole-dollar value
dit available as first reported to Equifax. Minimum value $0
Important Note: With the release of Maximum value $999,999,999
the Credit Reporting Code in Not applicable to Telco’s or
September 2022, the Office of the Utilities.
Australian Information Commissioner Not applicable if maximum
(OAIC) has determined that current amount of credit available has no
Consumer Credit Liability Information fixed limit. e.g. certain Charge
(CCLI) only should be disclosed to Cards
ensure consistency across Credit Note: This field will no longer be
Reporting Bodies. Hence, Original returned
Maximum Amount of Credit Available
field will no longer be returned.
2.1.5.3.1.20.1 @currency-code Attribute 0-1 Currency code 3 F The only currency supported at
this stage is AUD
2.1.5.3.1.21 latest-maximum-amount-credi Element 0-1 Latest maximum amount of credit 9 V Positive, whole-dollar value
t available reported to Equifax Minimum value $0
Maximum value $999,999,999
Not applicable to Telco’s or
Utilities.
Not applicable if maximum
amount of credit available has no
fixed limit. e.g. certain Charge
Cards
2.1.5.3.1.21.1 @currency-code Attribute 0-1 Currency code 3 F The only currency supported at
this stage is AUD
82
2.1.5.3.1.21.2 date-last-changed 0-1 The date a change in the maximum 10 F Format ccyy-mm-dd
Attribute amount of credit was last reported to
Equifax. Included in the response only if
a change in credit limit was recorded.
2.1.5.3.1.22 is-unlimited-credit Element 0-1 Indicates whether credit amount 5 V
available is unlimited.
Note: This field is equivalent in meaning
and use to the ACRDS no-fixed-limit
field.
2.1.5.3.1.23 additional-data-fields Container 0-1 Contains additional data fields.
2.1.5.3.1.23.1 data-field Container 1-M Contains a key/value pair for a custom
parameter.
2.1.5.3.1.23.1.1 key Element 1 The custom input parameter key. 20 V term-unit-type will be returned
here when an account has an
associated optional unit of time
field. See 3.11 CCR Term of Loan
2.1.5.3.1.23.1.2 value Element 1 The custom input parameter value. 20 V The term unit type will be
returned here. Refer to 8.29 Term
of Loan Unit Type code table for
valid values.
The term-of-loan value (e.g. 60)
will be returned in term-of-loan
see 2.1.5.3.1.19
2.1.5.3.1.23.1.2.1 @unit Attribute 0-1 Future use only 20 V
2.1.5.3.1.24 association-information Container 0-1 Includes account association data Child XML elements of this
specific to the subject of the enquiry container element are defined
under 6.2.3.2.5.2.1 -
Association-information.
2.1.5.3.1.25 repayment-history Container 0-1 Includes repayment history information Child XML elements of this
for this account. container element are defined
under 6.2.3.2.5.2.2 -
Repayment-history .
2.1.5.3.1.26 defaults Container 0-1 Includes default information for this Child XML elements of this
account. container element are defined
under 6.2.3.2.5.2.3 -Defaults.
2.1.5.3.1.27 account-history Container 0-1 Includes historical information for this Child XML elements of this
account. container element are defined
83
under 6.2.3.2.5.2.4 -
Account-history
84
6.2.3.2.5.2.1 Association-information
Schema location: response>product-data>enquiry-report>consumer-credit-file> accounts>account >association-information
85
2.1.5.3.1.24.8 default-association-start-date Element 0-1 Date account holder started association with the 10 F Format
default state of the account ccyy-mm-dd
2.1.5.3.1.24.9 default-association-cease-date Element 0-1 Date account holder ceased association with the 10 F Format
default state of the account ccyy-mm-dd
2.1.5.3.1.24.10 additional-data-fields Container 0-1 Contains additional data fields. Will be used in the
future to report additional information.
2.1.5.3.1.24.10.1 data-field Container 1-M Future use only
2.1.5.3.1.24.10.1.1 key Element 1 Future use only 20 V
2.1.5.3.1.24.10.1.2 value Element 1 Future use only 20 V
2.1.5.3.1.24.10.1.2.1 @unit Attribute 0-1 Future use only 20 V
6.2.3.2.5.2.2 Repayment-history
Schema location: response>product-data>enquiry-report>consumer-credit-file> accounts>account >repayment-history
86
2.1.5.3.1.25 repayment-history Container 0-1 Includes repayment history and financial
hardship information for this account.
2.1.5.3.1.25.1 payment Container 1-M Includes repayment history and financial
hardship information for one repayment
period
2.1.5.3.1.25.1.1 @is-disputed Attribute 0-1 Future use only 5 V
2.1.5.3.1.25.1.2 @dispute-reported-date Attribute 0-1 Future use only 10 F Format ccyy-mm-dd
2.1.5.3.1.25.1.3 @dispute-code Attribute 0-1 Future use only 1 V
2.1.5.3.1.25.1.4 period Element 0-1 Repayment and financial hardship 7 F Format ccyy-mm
period year and month
2.1.5.3.1.25.1.5 status Element 0-1 The repayment history status of the 1 F Refer to 8.19 - Repayment History
account for the specified monthly period Status for valid values.
2.1.5.3.1.25.1.6 balance Element 0-1 Future use only 9 V
2.1.5.3.1.25.1.6.1 @currency-code Attribute 0-2 Future use only 3 F The only currency supported at
this stage is AUD
2.1.5.3.1.25.1.7 utilisation Element 0-1 Future use only 5 V
2.1.5.3.1.25.1.8 additional-data-fields Container 0-1 Contains additional data fields.
2.1.5.3.1.25.1.8.1 data-field Container 1-M Contains a key/value pair for a custom
parameter
2.1.5.3.1.25.1.8.1.1 key Element 1 fin-hardship-ind will be returned here 20 V
when the payment period has an
associated financial hardship indicator.
2.1.5.3.1.25.1.8.1.2 value Element 1 The type of financial hardship indicator 20 V Refer to 8.21 Financial Hardship
will be returned here. Information for valid values.
2.1.5.3.1.25.1.8.1.2.1 @unit Attribute 0-1 Future use only 20 V
87
6.2.3.2.5.2.3 Defaults
Schema location: response>product-data>enquiry-report>consumer-credit-file> accounts>account >defaults
response>product-data>enquiry-report>commercial-credit-file> accounts>account >defaults
88
2.1.5.3.1.26.1 default Container 1-M Includes information for one default
2.1.5.3.1.26.1.1 @is-disputed Attribute 0-1 Future use only 5 V
2.1.5.3.1.26.1.2 @dispute-reported-d Attribute 0-1 Future use only 10 F Format ccyy-mm-dd
ate
2.1.5.3.1.26.1.3 @dispute-code Attribute 0-1 Future use only 1 V
2.1.5.3.1.26.1.4 status Element 0-1 The payment status of the debt 25 V Refer to 8.7 - Default Status code table
for valid values
2.1.5.3.1.26.1.4.1 @code Attribute 0-1 Code used for default status 1 F
2.1.5.3.1.26.1.5 status-date Element 0-1 Date of last status update on default 10 F Format ccyy-mm-dd
2.1.5.3.1.26.1.6 is-accelerated-debt Element 0-1 Future use only 5 V Set to true if present.
2.1.5.3.1.26.1.7 original-default Container 0-1 Includes default information as
originally reported
2.1.5.3.1.26.1.7.1 date-recorded Element 0-1 Date the account was originally 10 F Format ccyy-mm-dd
reported as in default.
2.1.5.3.1.26.1.7.2 default-amount Element 0-1 Original default amount 9 V
2.1.5.3.1.26.1.7.2.1 @currency-code Attribute 0-1 Currency code 3 F The only currency supported at this
stage is AUD
2.1.5.3.1.26.1.7.3 reason-to-report Element 0-1 For commercial defaults only. 70 V Refer to 8.7 - Default Reason to Report
Reason the default was originally (commercial defaults only) code table
reported. for valid values
2.1.5.3.1.26.1.7.3.1 @code Attribute 0-1 For commercial defaults only. 2 V
Code used for reason to report
2.1.5.3.1.26.1.8 current-default Container 0-1 Includes current default information
2.1.5.3.1.26.1.8.1 date-recorded Element 0-1 Date the default information was last 10 F Format ccyy-mm-dd
updated.
2.1.5.3.1.26.1.8.2 default-amount Element 0-1 Current default amount 9 V
2.1.5.3.1.26.1.8.2.1 @currency-code Attribute 0-1 Currency code 3 F The only currency supported at this
stage is AUD
2.1.5.3.1.26.1.8.3 reason-to-report Element 0-1 For commercial defaults only. 70 V Refer to 8.7 - Default Reason to Report
Reason the default was last reported. (commercial defaults only) code table
for valid values
2.1.5.3.1.26.1.8.3.1 @code Attribute 0-1 Code used for reason to report 2 V
2.1.5.3.1.26.1.9 additional-data-fields Container 0-1 Contains additional data fields.
2.1.5.3.1.26.1.9.1 data-field Container 1-M Contains a key/value pair for a custom
parameter
89
2.1.5.3.1.26.1.9.1.1 key Element 1 new-arrangement-flag will be returned 20 V
here when a new arrangement applies
to the default
2.1.5.3.1.26.1.9.1.2 value Element 1 The type of new arrangement will be 20 V Refer to 8.9 Default New Arrangement
returned here. code table for valid values.
2.1.5.3.1.26.1.9.1.2.1 @unit Attribute 0-1 Future use only 20 V
6.2.3.2.5.2.4 Account-history
Schema location: response>product-data>enquiry-report>consumer-credit-file>accounts>account>account-history
90
2.1.5.3.1.27.1.7.1.1 @unit Attribute 0-1 Future use only 20 V
2.1.5.3.1.27.1.7.1.2 name Element 0-1 Future use only 30 V
2.1.5.3.1.27.1.7.1.3 prior-value Element 0-1 Future use only 40 V
2.1.5.3.1.27.1.7.1.3.1 @code Attribute 0-1 Future use only 4 V
2.1.5.3.1.27.1.7.1.4 updated-value Element 0-1 Future use only 40 V
2.1.5.3.1.27.1.7.1.4.1 @code Attribute 0-1 Future use only 4 V
6.2.3.2.5.3 Messages
Schema location: response>product-data>enquiry-report>consumer-credit-file> messages
response>product-data>enquiry-report>commercial-credit-file> messages
response>product-data>enquiry-report>public-record-or-consumer-credit-information > messages
Figure 24 - messages
Message Body Content Table
Seq No XML Element Type O/C Description Len V/F Format and Validation Rules
2.1.5.4 messages Container 0-1 Includes messages in relation to this section the report
2.1.5.4.1 message Element 1-9 Message (renamed, was file-message in VedaScore 1.1) 20 V
9 0
2.1.5.4.1.1 @code Attribute 0-1 The code assigned to this product message 10 V
6.2.3.2.6 Commercial-credit-file
Schema location: response>product-data>enquiry-report>commercial-credit-file
91
Figure 25 - commercial-credit-file overview
Message Body Content Table
Seq XML Element Type O/C Description
No
2.1.6 commercial-credi Container 0-1 Commercial data is included only if the permission type specified in the request includes commercial data
t-file
2.1.6.1 file-notes Container 0-1 Contains notes appended to the individual's credit file. Notes can include important information and it is highly
recommended to implement the capability to read and display these.
Child XML elements of this container element are defined under 6.2.3.2.6.1-File-notes.
2.1.6.2 credit-enquiries Container 0-1 Includes information about credit-enquiries (commercial only), credit applications (consumer only) and authorised
agent enquiries (commercial only).
Child XML elements of this container element are defined under 6.2.3.2.5.1 - Credit-enquiries.
2.1.6.3 accounts Container 0-1 Includes information about the subject's accounts.
Child XML elements of this container element are defined under 6.2.3.2.5.2-Accounts.
2.1.6.4 messages Container 0-1 Includes messages in relation to this section the report.
Child XML elements of this container element are defined under 6.2.3.2.5.3- Messages.
6.2.3.2.6.1 File-notes
Schema location:
response>product-data>enquiry-report>commercial-credit-file>file-notes
92
Figure 26: File-notes
Message Body Content Table
Seq No XML Element Type O/C Description Len V/F Format and
Validation Rules
2.1.5.1 file-notes Container 0-1 Contains notes appended to the individual's credit file. Notes can include
important information and it is highly recommended to implement the
capability to read and display these.
2.1.5.1.1 file-note Container 1-15 File note
2.1.5.1.1.1 @code Attribute 0-1 Future use only 10 V
2.1.5.1.1.2 @date-recorded Attribute 0-1 Date the file note was recorded 10 F Format
ccyy-mm-dd
2.1.5.1.1.3 id-references Container 0-1 Includes a list of id-references
2.1.5.1.1.3. id-reference Element 1-M Reference to associate the source of this information to the identity defined 3 V
1 by identity index.
2.1.5.1.1.4 note Element 0-1 The file note content 63 V
93
Figure 27: public-record-or-consumer-credit-information
Message Body Content Table
Seq XML Element Type O/C Description
No
2.1.7 public-record-or-consumer-c Container 0-1 In the context of a consumer enquiry, this section includes consumer credit information.
redit-information In the context of a commercial enquiry, this section includes public records.
2.1.7.1 court-actions Container 0-1 Includes information about default judgements, writs, summonses and claims.
Child XML elements of this container element are defined under 6.2.3.2.7.1 Court Actions.
2.1.7.2 disqualified-directorships Container 0-1 Includes periods for which the subject has been disqualified by the ASIC from holding executive office.
Child XML elements of this container element are defined under 6.2.3.2.7.2-Disqualified-directorships.
2.1.7.3 directorships Container 0-1 Includes current and previous directorships held by the subject.
Child XML elements of this container element are defined under 6.2.3.2.7.3-Directorships.
2.1.7.4 business-names Container 0-1 Includes the list of business names held by the subject.
Child XML elements of this container element are defined under 6.2.3.2.7.4-Business-names.
2.1.7.5 personal-insolvencies Container 0-1 Includes information about personal insolvencies.
Child XML elements of this container element are defined 6.2.3.2.7.5 Personal-insolvencies.
2.1.7.6 sole-trader Container 0-1 Future use only
Child XML elements of this container element are defined under 6.2.3.2.7.6-Sole-trader (p.).
2.1.7.7 messages Container 0-1 Includes messages in relation to this section of the report.
Child XML elements of this container element are defined under 6.2.3.2.5.3- Messages.
94
6.2.3.2.7.1 Court-actions
Schema location: response>product-data>enquiry-report>public-record-or-consumer-credit-information>court-actions
Note: Due to changes to the Privacy (Credit Reporting) Code 2014 that came into effect on 14 February 2020, Writs and Summons data is no longer
considered publicly available information and will no longer be collected for disclosure in consumer credit reports.
95
Seq No XML Element Type O/C Description Len V/F Format and Validation Rules
2.1.7.1 court-actions Containe 0-1 Includes information about default judgements
r and other court actions (such as writs and
summons).
2.1.7.1.1 court-action Containe 1-2 Includes details of one court action
r 0
2.1.7.1.1.1 @is-disputed Attribute 0-1 Future use only 5 V
2.1.7.1.1.2 @dispute-reported-dat Attribute 0-1 Future use only 10 F Format ccyy-mm-dd
e
2.1.7.1.1.3 @dispute-code Attribute 0-1 Future use only 1 V
2.1.7.1.1.4 @type Attribute 0-1 The type of court action: default-judgement or 20 V
other-court-action (such as writs and summons).
2.1.7.1.1.5 id-references Containe 0-1 Includes a list of id-references
r
2.1.7.1.1.5.1 id-reference Element 1-M Reference to associate the source of this 3 V
information to the identity defined by identity
index.
2.1.7.1.1.6 action-date Element 0-1 The date when a court judgement was signed or a 10 F Format ccyy-mm-dd
writ, summons or claim was issued
2.1.7.1.1.7 creditor Element 0-1 Name of the creditor 40 V
2.1.7.1.1.8 court-action-amount Element 0-1 Dollar amount of Court Action 9 V
2.1.7.1.1.8.1 @currency-code Attribute 0-1 Currency code 3 F The only currency supported at
this stage is AUD
2.1.7.1.1.9 plaint-number Element 0-1 Identification of the action as supplied by the 40 V
court
2.1.7.1.1.10 court-type Element 0-1 Type of court in which the action took place 30 V
2.1.7.1.1.11 relationship Element 0-1 Indicates whether the subject was a single 30 V
borrower or part of an association
2.1.7.1.1.11.1 @code Attribute 0-1 Type of relationship (code) 1 F Refer to 8.18 - Relationship code
table for valid values
2.1.7.1.1.12 co-borrower Element 0-1 Name of the co-borrower if the subject was part 40 V
of an association
2.1.7.1.1.13 court-action-status Element 0-1 Current status of the court action 30 V
2.1.7.1.1.13.1 @date Attribute 0-1 Status date 10 F Format ccyy-mm-dd
2.1.7.1.1.13.2 @code Attribute 0-1 Status code 1 F Refer to 8.4 - Court action status
code table for valid values
96
2.1.7.1.1.14 additional-data-fields Containe 0-1 Contains additional data fields. Will be used in the
r future to report additional information.
2.1.7.1.1.14.1 data-field Containe 1-M Future use only
r
2.1.7.1.1.14.1.1 key Element 1 Future use only 20 V
2.1.7.1.1.14.1.2 value Element 1 Future use only 20 V
2.1.7.1.1.14.1.2. @unit Attribute 0-1 Future use only 20 V
1
6.2.3.2.7.2 Disqualified-directorships
Schema location: response>product-data>enquiry-report>public-record-or-consumer-credit-information>disqualified-directorships
97
2.1.7.2.1.4 @last-extract-date Attribute 0-1 Date of when the disqualified directorship details were 10 F Format ccyy-mm-dd
last extracted from ASIC.
2.1.7.2.1.5 @last-extract-time Attribute 0-1 Time of when the disqualified directorship details were 20 V Format
last extracted from ASIC. hh:mm:ss.sss(+|-)hh:
mm
2.1.7.2.1.6 @last-update-date Attribute 0-1 Date of when the disqualified directorship details were 10 F Format ccyy-mm-dd
last updated from ASIC.
As opposed to an extract, an update might only refresh a
subset of the data.
2.1.7.2.1.7 @last-update-time Attribute 0-1 Time of when the disqualified directorship details were 20 V Format
last updated from ASIC. hh:mm:ss.sss(+|-)hh:
mm
2.1.7.2.1.8 id-references Container 0-1 Includes a list of id-references
2.1.7.2.1.8.1 id-reference Element 1-M Reference to associate the source of this information to 3 V
the identity defined by identity index.
2.1.7.2.1.9 date-disqualified Element 0-1 Date of disqualification 10 F Format ccyy-mm-dd
2.1.7.2.1.10 date-disqualified-until Element 0-1 Date disqualification will be lifted 10 F Format ccyy-mm-dd
2.1.7.2.1.11 additional-data-fields Container 0-1 Contains additional data fields. Will be used in the future
to report additional information.
2.1.7.2.1.11.1 data-field Container 1-M Future use only
2.1.7.2.1.11.1.1 key Element 1 Future use only 20 V
2.1.7.2.1.11.1.2 value Element 1 Future use only 20 V
2.1.7.2.1.11.1.2.1 @unit Attribute 0-1 Future use only 20 V
6.2.3.2.7.3 Directorships
Schema location: response>product-data>enquiry-report>public-record-or-consumer-credit-information>directorships
98
Figure 30: directorships
Message Body Content Table
Seq No XML Element Type O/C Description Len V/F Format and Validation Rules
2.1.7.3 directorships Container 0-1 Includes current and previous
directorships held by the subject
2.1.7.3.1 directorship Container 1-100 Includes details of one current or
previous directorship
2.1.7.3.1.1 @is-disputed Attribute 0-1 Future use only 5 V
2.1.7.3.1.2 @dispute-reported-date Attribute 0-1 Future use only 10 F Format ccyy-mm-dd
2.1.7.3.1.3 @dispute-code Attribute 0-1 Future use only 1 V
2.1.7.3.1.4 @type Attribute 0-1 Determines whether the directorship 1 F
is current (C) or previous (P)
2.1.7.3.1.5 @last-extract-date Attribute 0-1 Date of when the directorship details 10 F Format ccyy-mm-dd
were last extracted from ASIC.
2.1.7.3.1.6 @last-extract-time Attribute 0-1 Time of when the directorship details 20 V Format hh:mm:ss.sss(+|-)hh:mm
were last extracted from ASIC.
2.1.7.3.1.7 @last-update-date Attribute 0-1 Date of when the directorship details 10 F Format ccyy-mm-dd
were last updated from ASIC.
99
As opposed to an extract, an update
might only refresh a subset of the
data.
2.1.7.3.1.8 @last-update-time Attribute 0-1 Time of when the directorship details 20 V Format hh:mm:ss.sss(+|-)hh:mm
were last updated from ASIC.
2.1.7.2.1.9 id-references Container 0-1 Includes a list of id-references
2.1.7.2.1.9.1 id-reference Element 1-M Reference to associate the source of 3 V
this information to the identity
defined by identity index.
2.1.7.3.1.10 date-appointed Element 0-1 Date when the subject was 10 F Format ccyy-mm-dd
appointed director of the
organisation
2.1.7.3.1.11 date-ceased Element 0-1 Date when the subject ceased to be 10 F Format ccyy-mm-dd
a director of the organisation
2.1.7.3.1.12 date-last-known-as-director Element 0-1 Date when the subject was last 10 F Format ccyy-mm-dd
recorded as a director
2.1.7.3.1.13 organisation Container 0-1 Includes the organisation details
2.1.7.3.1.13.1 bureau-reference Element 0-1 Equifax internal unique reference for 10 V
this organisation
2.1.7.3.1.13.2 name Element 0-1 Name of the organisation 200 V
2.1.7.3.1.13.3 name-start-date Element 0-1 Date the name was registered or 10 F Format ccyy-mm-dd
reserved with ASIC
2.1.7.3.1.13.4 type Element 0-1 Type of organisation 30 V
2.1.7.3.1.13.4.1 @code Attribute 0-1 Associated code 3 F Refer to 8.14 - Organisation Type
code table for valid values
2.1.7.3.1.13.5 status Element 0-1 Status of the organisation (returned 60 V
only when @type = current (C))
2.1.7.3.1.13.5.1 @code Attribute 0-1 Associated code 4 V Refer to 8.13 - Organisation Status
code table for valid values
2.1.7.3.1.13.6 organisation-number Element 0-1 The organisation number. 9 F
2.1.7.3.1.13.7 ABN Element 0-1 The organisation's Australian 11 F
Business Number
2.1.7.3.1.14 additional-data-fields Container 0-1 Contains additional data fields. Will
be used in the future to report
additional information.
2.1.7.3.1.14.1 data-field Container 1-M Future use only
2.1.7.3.1.14.1.1 key Element 1 Future use only 20 V
100
2.1.7.3.1.14.1.2 value Element 1 Future use only 20 V
2.1.7.3.1.14.1.2.1 @unit Attribute 0-1 Future use only 20 V
2.1.7.3.1.15 organisation-summary Container 0-1 Contains a trading history summary This section is only returned for a
of the organisation the individual directorship or previous directorship
is/was a director of. if the trading history variant was
requested.
2.1.7.3.1.15.1 enquiries Element 1 The number of enquiries found for 2 V Returns a maximum count of 50.
the organisation.
2.1.7.3.1.15.2 payment-defaults Element 1 The number of payment defaults 2 V Returns a maximum count of 25.
found for the organisation.
2.1.7.3.1.15.3 Mercantile Element 1 The number of mercantile enquiries 2 V Returns a maximum count of 10.
found for the organisation.
2.1.7.3.1.15.4 court-writs Element 1 The number of court writs found for 2 V Returns a maximum count of 10.
the organisation.
2.1.7.3.1.15.5 court-actions Element 1 The number of court actions found 2 V Returns a maximum count of 10.
for the organisation.
2.1.7.3.1.15.6 current-directors Element 1 The number of current directors 2 V Returns a maximum count of 50.
found for the organisation.
2.1.7.3.1.15.7 previous-directors Element 1 The number of previous directors 2 V Returns a maximum count of 50.
found for the organisation.
2.1.7.3.1.15.8 proprietorships Element 1 The number of proprietorships found 2 V Returns a maximum count of 50.
for the organisation.
6.2.3.2.7.4 Business-names
Schema location: response>product-data>enquiry-report>public-record-or-consumer-credit-information>business-names
101
Figure 31: business-names
Message Body Content Table
Seq No XML Element Type O/C Description Len V/F Format and Validation Rules
2.1.7.4 business-names Container 0-1 Includes the list of business names held
by the subject
2.1.7.4.1 business-name Container 1-50 Includes details about one business
name held by the subject (previously
referred to as proprietorship)
2.1.7.4.1.1 @is-disputed Attribute 0-1 Future use only 5 V
2.1.7.4.1.2 @dispute-reported-date Attribute 0-1 Future use only 10 F Format ccyy-mm-dd
2.1.7.4.1.3 @dispute-code Attribute 0-1 Future use only 1 V
2.1.7.4.1.4 @last-extract-date Attribute 0-1 Date of when the business name details 10 F Format ccyy-mm-dd
were last extracted from ASIC.
2.1.7.4.1.5 @last-extract-time Attribute 0-1 Time of when the business name details 20 V Format
were last extracted from ASIC. hh:mm:ss.sss(+|-)hh:mm
2.1.7.4.1.6 @last-update-date Attribute 0-1 Date of when the business name details 10 F Format ccyy-mm-dd
were last updated from ASIC.
As opposed to an extract, an update
might only refresh a subset of the data.
102
2.1.7.4.1.7 @last-update-time Attribute 0-1 Time of when the business name details 20 V Format
were last updated from ASIC. hh:mm:ss.sss(+|-)hh:mm
2.1.7.4.1.8 id-references Container 0-1 Includes a list of id-references
2.1.7.4.1.8.1 id-reference Element 1-M Reference to associate the source of this 3 V
information to the identity defined by
identity index.
2.1.7.4.1.9 start-date Element 0-1 Date when the individual became the 10 F Format ccyy-mm-dd
owner of the business name
2.1.7.4.1.10 business Container 0-1 Includes the business details
2.1.7.4.1.10.1 bureau-reference Element 0-1 Equifax internal unique reference for this 10 V
organisation
2.1.7.4.1.10.2 name Element 0-1 Business name 200 V
2.1.7.4.1.10.3 previous-state-or-territory-regist Container 0-1 State registration details. Only available
ration for business names registered prior to
National Business Names reform in May
2012.
2.1.7.4.1.10.3.1 state Element 0-1 The code of the state or territory where 3 V Refer to 8.24 - State code
the business name was registered table for valid values.
2.1.7.4.1.10.3.2 number Element 0-1 The number assigned by the state for 15 V
registration of the business
2.1.7.4.1.10.4 ABN Element 0-1 Australian Business Number 11 F
business-name-id Element 0-1 Future use only
2.1.7.4.1.10.5 10 V
2.1.7.4.1.10.6 business-summary Container 0-1 Contains a trading history summary of This section is only returned
the business name. for a directorship or previous
directorship if the trading
history variant was
requested.
2.1.7.4.1.10.6.1 enquiries Element 1 The number of enquiries found for the Returns a maximum count of
2 V
business name. 50.
2.1.7.4.1.10.6.2 payment-defaults Element 1 The number of payment defaults found Returns a maximum count of
2 V
for the business name. 25.
2.1.7.4.1.10.6.3 mercantile Element 1 The number of mercantile enquiries Returns a maximum count of
2 V
found for the business name. 10.
2.1.7.4.1.10.6.4 proprietorships Element 1 The number of Returns a maximum count of
2 V
proprietorships/proprietors found for 50.
the business name.
103
2.1.7.4.1.10.6.5 court-writs Element 1 The number of court writs found for the Returns a maximum count of
2 V
business name. 10.
2.1.7.4.1.10.6.6 court-actions Element 1 The number of court actions found for Returns a maximum count of
2 V
the business name. 10.
2.1.7.4.1.10.6.7 current-directors Element 1 The number of current directors found Returns a maximum count of
2 V
for the organisation. (Please disregard 50.
the field for Business Names
2.1.7.4.1.10.6.8 previous-directors Element 1 The number of previous directors found Returns a maximum count of
2 V
for the organisation. 50.
additional-data-fields Container 0-1 Contains additional data fields. Will be
2.1.7.4.1.11
used in the future to report additional
information.
data-field Container 1-M Future use only
2.1.7.4.1.11.1
key Element 1 Future use only 20 V
2.1.7.4.1.11.1.1
value Element 1 Future use only 20 V
2.1.7.4.1.11.1.2
@unit Attribute 0-1 Future use only 20 V
2.1.7.4.1.11.1.2.1
104
6.2.3.2.7.5 Personal-insolvencies
Schema location: response>product-data>enquiry-report>public-record-or-consumer-credit-information>personal-insolvencies
105
2.1.7.5.1.4 id-references Container 0-1 Includes a list of id-references
2.1.7.5.1.4.1 id-reference Element 1-M Reference to associate the source of this 3 V
information to the identity defined by identity
index.
2.1.7.5.1.5 type Element 0-1 Full description of the type of insolvency 60 V
(previously named bankruptcy-type)
2.1.7.5.1.5 @code Attribute 0-1 Associated code 1 F Refer to 8.17- Personal
Insolvency Type code table for
valid values
2.1.7.5.1.6 date-declared Element 0-1 Date the bankruptcy was declared 10 F Format ccyy-mm-dd
2.1.7.5.1.7 text Element 0-1 The type of administration or petition 50 V
2.1.7.5.1.8 administration-id Container 0-1 Administration identifier (previously called
proceedings)
2.1.7.5.1.8.1 district Element 0-1 The district the matter was commenced in 3 V Refer to 8.24 - State code table
(previously called state). for valid values.
2.1.7.5.1.8.2 year Element 0-1 The year in which the application/estate 4 F
commenced.
2.1.7.5.1.8.3 number Element 0-1 The number from the source system 8 V
2.1.7.5.1.8.4 proceedings-status Element 0-1 Either Part 9 or Part 10. 7 V
2.1.7.5.1.9 status Element 0-1 Current status of the personal insolvency 28 V
2.1.7.5.1.9.1 @code Attribute 0-1 Associated code 1 F Refer to 8.16 - Personal
Insolvency Status code table for
valid values
2.1.7.5.1.10 status-date Element 0-1 Date the personal insolvency was discharged, 10 F Format ccyy-mm-dd
terminated or completed
2.1.7.5.1.11 relationship Element 0-1 Indicates if other persons are part of the same 30 V
application/joint estate (previously called role).
2.1.7.5.1.11.1 @code Attribute 0-1 Type of relationship (code) 1 F
Refer to 8.18 - Relationship code
table for valid values
2.1.7.5.1.12 co-borrower Element 0-1 Name of other person who is part of the same 40 V
application/joint estate
2.1.7.5.1.13 trustee Container 0-1 Future use only
2.1.7.5.1.13.1 name Element 0-1 Future use only 60 V
2.1.7.5.1.13.2 business-name Element 0-1 Future use only 30 V
2.1.7.5.1.13.3 business-address Element 0-1 Future use only 400 V
2.1.7.5.1.13.4 phone-number Element 0-1 Future use only 20 V
106
2.1.7.5.1.14 additional-data-fields Container 0-1 Contains additional data fields. Will be used in
the future to report additional information.
2.1.7.5.1.14.1 data-field Container 1-M Future use only
2.1.7.5.1.14.1.1 key Element 1 Future use only 20 V
2.1.7.5.1.14.1.2 value Element 1 Future use only 20 V
2.1.7.5.1.14.1.2.1 @unit Attribute 0-1 Future use only 20 V
6.2.3.2.7.6 Sole-trader
Schema location: response>product-data>enquiry-report>public-record-or-consumer-credit-information>sole-trader
107
6.2.3.3 Summary-data
Schema location: response>product-data> summary-data
108
Apply (Utility) and Equifax Apply
(Alternative Lending) return an
additional (Telco, Utility or
Alternative Lending) data block.
2.2.1.1 @type Attribute 1 Indicates whether this list of characteristics is a 8 F
standard set or a custom set list. Custom
characteristic lists are a future product feature and
will be configuration driven.
2.2.1.2 @name Attribute 1 Name associated with the data block. The standard 50 V
data block name is Genesis.
2.2.1.3 characteristic Container 1-M Contains information about a characteristic data
item.
2.2.1.3.1 @id Attribute 1 Characteristic ID which uniquely identifies the 6 V
characteristic.
2.2.1.3.2 @key-characteristic Attribute 0-1 Indicates whether the characteristic returned is a 5 V
key characteristic. Key characteristics are flagged
so that they can be easily identified to render on a
screen or a report.
2.2.1.3.3 variable-name Element 1 Name of the variable 40 V
2.2.1.3.4 description Element 1 Description of the characteristic 150 V
2.2.1.3.5 value Element 1 Value of the characteristic. 20 V
2.2.1.3.5.1 @unit Attribute 0-1 Use of measure associated with the value. 20 V
2.2.1.3.6 data-level Element 0-1 Indicates the data level type of the characteristic. A 20 V
characteristic can be derived based on Negative,
Partial or Comprehensive data.
2.2.1.3.6.1 @code Attribute 0-1 Code associated with the data level 1 F Refer to 8.6 - Data Level code table for
valid values
109
6.2.3.4 Score-data
Schema location: response>product-data> score-data
110
2.3.1.2.2 name Element 1 Name of the scorecard used to calculate the score. 50 V
2.3.1.2.3 version Element 1 Version of the scorecard. 4 V
2.3.1.2.4 type Element 0-1 Indicates the type of scorecard. e.g. Consumer, Consumer + 40 V
Commercial
2.3.1.2.5 data-level Element 0-1 Indicates the data level type of the scorecard. A scorecard 20 V
developed for Negative, Partial or Comprehensive data.
2.3.1.2.5.1 @code Attribute 0-1 Code associated with the data level 1 F Refer to 8.6 - Data Level
code table for valid
values
2.3.1.3 risk-odds Element 0-1 Odds of adverse information in the next 12 months calculated 18 V Note: Risk-odds is
against the full population. returned as a decimal
Risk odds returns the Good Bad odds of the given applicants value. e.g.: 117.78
score band. For example, odds of 14 (i.e. 14:1) mean that of all (117.78:1)
the individuals with the same score as this particular applicant,
on average 14 applicants exhibit good credit behaviour while 1
applicant exhibits bad credit behaviour.
2.3.1.4 key-contributing-fact Container 0-1 Contains the key contributing factors which can impact risk. Refer to 8.11 - Key
ors Contributing Factors
(KCF) code tables for
valid values
2.3.1.4.1 contributing-factor Container 1-M Contains information about one of the contributing factors.
2.3.1.4.1.1 @id Attribute 0-1 Contributing factor ID which uniquely identifies the contributing 10 V
factor.
2.3.1.4.1.2 name Element 1 Name of the contributing factor. 60 V
2.3.1.4.1.3 description Element 0-1 Description of the contributing factor. 200 V
2.3.1.4.1.4 score-impactor Element 1 Describes the level of risk. e.g. Greatly increases risk. 40 V Refer to 8.20 - Score
Impactors code table for
valid values
2.3.1.4.1.4. @code Attribute 0-1 Future use only 2 F
1
2.3.1.5 score-masterscale Element 1 Score. 6 V Refer 8.22 - Special
Score Values for a list
of special values.
2.3.1.6 additional-fields Container 0-1 Future use only
2.3.1.6.1 data-field Container 1-M Future use only
2.3.1.6.1.1 Key Element 1 Future use only 20 V
2.3.1.6.1.2 value Element 1 Future use only 20 V
111
2.3.1.6.1.2. @unit Attribute 0-1 Future use only 20 V
1
6.2.3.5 Possible-matches
Schema location: response>product-data> possible-matches
112
Figure 37: File-ban-report
Message Body Content Table
Seq XML Element Type O/C Description Len V/F Format and
No Validation Rules
2.4 file-ban-report Contain 0-1 Indicates whether the individual is under a Ban. If the individual is under a Ban then
er the enquiry-report element will not be returned. Mutually exclusive. Ban Flags are a
requirement under the Privacy Act.
2.4.1 reported-date Element 0-1 Reported date of the Ban. 10 F Format
ccyy-mm-dd
2.4.2 is-extended Element 0-1 Indicates whether the Ban is an extension. 5 V
2.4.3 end-date Element 1 End date of the Ban. 10 F Format
ccyy-mm-dd
This web service operation allows the user to retrieve an enquiry report which has been generated previously using the new enquiry operation or to pick-up
an enquiry response that was originally requested in asynchronous mode.
113
The following illustration depicts the general structure of the ticket response.
6.3.2.1 Request-by-enquiry-id
Message Body Content Table
Seq XML Type O/C Description Len V/ Format and Validation
No Element F Rules
1 enquiry-id Element 1 System generated unique ID related to a particular response 20 V
transaction.
114
7 Other Response Considerations
7.1 Responses to matching of identification data from the request
The table below lays out the possible responses of matching to identification data from the request.
Condition Result Response
Request by Identity Details
No match for a Credit The system creates a new file and For the created file, a primary match element with a
Provider records a credit enquiry based on the bureau number and details from the request.
data supplied in your request.
No match for an The system returns a general message A general message element.
Access Seeker indicating that the subject of your
enquiry was not found
One strong match and The information in your request is A primary-match element with details from the
no possible matches added to the individual Consumer or individual Consumer and/or individual Commercial file
individual Commercial file. and the Public record file.
One strong and one The information in your request is For the strong match, a primary-match element with
possible matches added to the individual Consumer or details from the individual Consumer and/or
individual Commercial file for the individual Commercial file and the Public record file.
strong match. For the possible match(es), a possible-match element
with the file number and identity details.
No strong match and The system creates a new file based on For the created file, a primary match element with a
one or more possible the data supplied in your request. bureau number and details from the request.
matches for a credit For the possible match(es), a possible-match element
provider with the file number and identity details.
No strong match and The system returns a general message A general message element.
one or more possible indicating that the subject of your
matches for an Access enquiry was not found
Seeker
115
Note for Alternative Lending Customers
Equifax Apply (Alternative Lending) product also uses the same matching conditions as those used
for Credit Providers (listed above).
040000-049999 User has attempted to submit a request which Primary: Correct original request and resubmit
fails minimum request validation rules. as a new request.
116
8 Code Tables
NOTE
The following tables are provided for indicative purposes and may be subject to further changes. It is therefore
recommended for client systems to be designed in such a way as to cater for other values being returned in
addition to those listed in these tables.
117
HC Hire Purchase
L Leasing
LP Lending Proposal
OD Bank Overdraft
PF Premium Finance
PL Personal Loan
RM Real Estate Mortgage
SR Search Request
TF Trade Finance
TC Telecommunication services
UA Utilities
WF Wholesale Finance
7 7-Day Account
30 30-Day Account
60 60-Day Account
90 90-Day Account
118
R Repossession (Loss not yet established)
RC Referred to Collection or Collection Agency
RL Repossession Loss (After sale of the item)
SA Scheme of Arrangement
VS Voluntary Surrender
WO Bad Debt Written Off
WX Write Off (Monitoring Complete)
*Note: The Office of the Australian Information Commissioner (OAIC) has recently provided a view that the only lawful
disclosure of payment information is that a default has been paid (‘P’ code). Prior to this, the industry practice was for
payment of defaults to be disclosed as either paid in full (‘P’ code) or settled for a lesser amount (‘S’ code). From 15 February
2019, all existing ‘S’ codes were converted to ‘P’ codes on the Equifax consumer bureau. Hence ‘S’ is no longer a valid Default
status.
To bring the CR Code in line with the views previously expressed by the OAIC.As of 14th February 2020, all existing ‘C’ codes
will be converted to ‘P’ codes on the Equifax consumer bureau. Hence ‘C’ is no longer a valid default status.
The Disputed status is no longer available oin the Equifax Consumer bureau for both consumer and commercial defaults.
8.11 Gender
Gender Code Table
Code Description
M Male
F Female
U Unknown
119
8.12 Key Contributing Factors (KCF)
120
KCF-018 Bankrupt Bankrupt (excluding Discharged, Part X, Part IX) as at time of Negative
enquiry
KCF-019 Part X Personal Insolvency Part X Personal Insolvency Agreement (excluding Discharged Negative
Agreement and Terminated) as at time of enquiry
KCF-020 Part IX Debt Agreement Part IX Debt Agreement (excluding Discharged and Terminated) Negative
as at time of enquiry
KCF-021 Discharged Bankrupt Discharged Bankrupt (excluding Part X, and Part IX) as at time Negative
of enquiry
KCF-022 Part X Personal Insolvency Part X Personal Insolvency Agreement Discharged as at time of Negative
Agreement Discharged enquiry
KCF-023 Part IX Debt Agreement Part IX Debt Agreement Discharged as at time of enquiry Negative
Discharged
KCF-024 Part X Personal Insolvency Part X Personal Insolvency Agreement Terminated as at time of Negative
Agreement Terminated enquiry
KCF-025 Part IX Debt Agreement Part IX Debt Agreement Terminated as at time of enquiry Negative
Terminated
KCF-029 Deceased At least 1 report has flagged the individual as deceased at time Negative
of enquiry
KCF-030 Under 18 Individual is under 18 on their primary file. Negative
Applicable only to Access Seekers
KCF-031 Current Worst Repayment At least 1 open account with repayment status 4+ at time of Comprehensive
Status 4+ enquiry (excludes guarantor accounts)
121
Applicable only when permission type is YX
(Commercial+Consumer)
KCF-112 Public adverse information The existence of public adverse information such as court Negative
judgements and writs can have a powerful impact on risk.
KCF-113 Directorship or Directorship and Proprietor information can have an impact on Negative
Proprietorship Information risk
KCF-114 Current Payment Status Current repayment status can be a powerful indicator of risk. Comprehensive
Applicable only when permission type is YX
(Commercial+Consumer)
KCF-115 Account Repayment History Repayment history information can have an impact on risk. Comprehensive
Applicable only when permission type is YX
(Commercial+Consumer)
KCF-116 Time Since Observed The length of time since the last late payment made can be an Comprehensive
Delinquency indicator of risk.
Applicable only when permission type is YX
(Commercial+Consumer)
The following Key Contributing Factors can be returned in the case of a special score scenario
KCF-118 Bankrupt Bankrupt (excluding Discharged, Part X, Part IX) as at time of Negative
enquiry
KCF-119 Part X Personal Insolvency Part X Personal Insolvency Agreement (excluding Discharged Negative
Agreement and Terminated) as at time of enquiry
KCF-120 Part IX Debt Agreement Part IX Debt Agreement (excluding Discharged and Terminated) Negative
as at time of enquiry
KCF-121 Discharged Bankrupt Discharged Bankrupt (excluding Part X, and Part IX) as at time Negative
of enquiry
KCF-122 Part X Personal Insolvency Part X Personal Insolvency Agreement Discharged as at time of Negative
Agreement Discharged enquiry
KCF-123 Part IX Debt Agreement Part IX Debt Agreement Discharged as at time of enquiry Negative
Discharged
KCF-124 Part X Personal Insolvency Part X Personal Insolvency Agreement Terminated as at time of Negative
Agreement Terminated enquiry
KCF-125 Part IX Debt Agreement Part IX Debt Agreement Terminated as at time of enquiry Negative
Terminated
KCF-129 Deceased At least 1 report has flagged the individual as deceased at time Negative
of enquiry
KCF-130 Under 18 Individual is under 18 on their primary file. Negative
Applicable only to Access Seekers
KCF-131 Current Worst Repayment At least 1 open account with repayment status 4+ at time of Comprehensive
Status 4+ enquiry (excludes guarantor accounts)
122
KCF-205 Current and Historic Credit The amount of credit an applicant has applied for can be an Negative
Amount Sought indicator of risk.
KCF-206 Authorised Agent Enquiries to authorised agents can impact risk. Negative
Information
KCF-207 Directorship Information Information on an applicant’s director’s file can impact risk. Negative
KCF-208 Age of File The age of an applicant’s file can be an indicator of risk. Negative
KCF-209 Age of File & Pattern of The spread of credit activity as it relates to the age of the applicant's Negative
Credit Applications file can impact risk.
KCF-210 Applicant Information Details of an applicant (such as age, employment and address Negative
details) can have an impact on risk.
KCF-211 Application Information Information included as part of the current application for credit can Negative
have an impact on risk.
KCF-212 Default Information The existence of default information on the consumer file can be a Negative
Recorded very powerful indicator of risk.
KCF-213 Court Writ Recorded The existence of court writ information on the file is a powerful Negative
indicator of increased risk.
KCF-214 Specific Default Data Specific default information has been shown to have an impact on Negative
the risk.
KCF-215 Default Judgement The existence of default judgement information on the applicant’s Negative
Information Recorded file can have a powerful impact on risk.
KCF-216 Proprietorship Information Proprietorship information on an applicant’s file can impact risk. Negative
KCF-217 Credit Provider Research shows that risk can be related to the type of credit Negative
Information provider being approached.
KCF-218 Specific Default Specific default judgement information can have an impact on risk. Negative
Judgement Data
KCF-220 Lack of Consumer Adverse No consumer adverse information: i.e. No defaults, default Negative
Information judgments, court writs and bankruptcies on file can have an impact
on risk.
KCF-221 Commercial Default The existence of commercial default information can be a very Negative
Information powerful indicator of risk.
Applicable only when permission type is XY (Consumer+Commercial)
KCF-222 Commercial Address Details of commercial address can have an impact on risk. Negative
Information Applicable only when permission type is XY (Consumer+Commercial)
123
KCF-033 Commercial Credit Commercial credit application history relating to number, frequency Negative
Application and Default and type of credit sought can have an impact on risk as well as
Information existence of commercial default information.
Applicable only when permission type is XY (Consumer+Commercial)
124
Commercial credit defaults and disqualified directorships or a directorship
Commercial Default & Disq
of a company in external administration demonstrates previous
KCF-324 Director or Company in Ext
non-payment of debt and may indicate a higher level of credit risk.
Admin
Applicable only when permission type is XY (Consumer+Commercial)
Disqualified Directorship or Director of Company in External Administration
KCF-325 Disqualified Directorship
can be an indicator of higher credit risk.
Stability of Residence and Residential and employment history are indicators of stability
KCF-326
Employment
Instability of Residence or Recent residential or employment changes may indicate higher credit risk.
KCF-327
Employment
KCF-328 Strong Credit History Having no arrears or defaults demonstrates better credit risk
The number and frequency of unsecured credit enquiries may indicate
KCF-329 More Unsecured Enquiries
higher credit risk.
Infrequent application for unsecured credit is an indicator of stability and
KCF-330 Fewer Unsecured Enquiries
responsible use of credit.
Type of facility applied for and lack of credit history are not indicative of
KCF-331 Better First Type of Credit Sought
higher credit risk.
Type of facility applied for and lack of credit history may indicate higher
KCF-332 Lesser First Type of Credit Sought
credit risk.
KCF-333 Few Telco Credit Enquiries Infrequent applications for telco facilities is an indicator of lower credit risk.
KCF-334 More Telco Credit Enquiries More frequent telco enquiries may indicate higher credit risk.
Infrequent enquiries for credit is an indicator of stability and responsible
KCF-335 Infrequent Enquiries
use of credit.
KCF-336 Frequent Enquiries The frequency and diversity of enquiries may indicate higher credit risk.
Stability of Residence and Residential and employment history are indicators of stability.
KCF-337
Employment
Instability of Residence or Recent residential or employment changes may indicate higher credit risk.
KCF-338
Employment
KCF-339 Changing Name Multiple Times Use of multiple aliases may indicate higher credit risk.
KCF-340 Long Credit History Longer credit history demonstrates experience with use of credit.
KCF-341 Lack of Credit History Available Short credit history may indicate a higher credit risk.
The nature and type of default information is not associated with significant
KCF-342 Less Serious Default
credit issues.
The nature and type of default information may indicate significant
KCF-343 More Serious Default
non-payment of debt and is associated with higher credit risk.
Having Residential Mortgage enquiries is an indicator of being in a good
KCF-344 Mortgage Applications
credit position and is associated with lower credit risk.
The geodemographic profile of the residential locality is associated with
KCF-345 Better Area Profile
lower credit risk.
The geodemographic profile of the residential locality is associated with
KCF-346 Lesser Area Profile
higher credit risk.
The following Key Contributing Factors can be returned in the case of a special score scenario
KCF-351 Exclusion - Bankruptcy Bankrupt (excluding Discharged, Part X, Part IX) as at time of enquiry.
KCF-352 Exclusion - Part X Personal Part X Personal Insolvency Agreement (excluding Discharged and
Insolvency Agreement Terminated) as at time of enquiry.
KCF-353 Exclusion - Part IX Debt Part IX Debt Agreement (excluding Discharged and Terminated) as at time of
Agreement enquiry.
KCF-354 Exclusion - Discharged Discharged Bankrupt (excluding Part X, and Part IX) as at time of enquiry.
Bankruptcy
KCF-355 Exclusion - Part X Personal Part X Personal Insolvency Agreement Discharged as at time of enquiry.
Insolvency Agreement
Discharged
KCF-356 Exclusion - Part IX Debt Part IX Debt Agreement Discharged as at time of enquiry.
Agreement Discharged
125
KCF-357 Exclusion - Part X Personal Part X Personal Insolvency Agreement Terminated as at time of enquiry.
Insolvency Agreement
Terminated
KCF-358 Exclusion - Part IX Debt Part IX Debt Agreement Terminated as at time of enquiry.
Agreement Terminated
KCF-359 Exclusion - Deceased At least 1 report has flagged the individual as deceased at time of enquiry.
KCF-360 Exclusion - Individual is under 18 Individual is under 18 on their primary file.
KCF-361 Exclusion - Lack of Credit There is not enough Credit Information to provide an Equifax One Score at
Information this time.
8.12.6 KCF for Equifax One Score – B2C – for Comparison Sites
Key Contributing Factors for One Score – B2C – for Comparison Sites
ID Name Description
KCF-301 Late payments of 30+ days Payments 30 days or more overdue drive down your credit score
considerably, so keep your payments up to date and on time.
KCF-302 Late payments of 15-29 days over Being 15-29 days late with repayments over a few months will hurt your
several months credit score. Regularly make your minimum repayments on time each
month to demonstrate good credit behaviour.
KCF-303 Number of loans and credit Having a number of loans or credit accounts with overdue repayments is a
accounts with overdue payments warning sign to lenders. Try not to miss payments on multiple accounts.
KCF-304 Loans and credit accounts in Having loan or credit accounts in arrears will drive down your credit score.
arrears Try to catch up on any late repayments within 14 days so you won’t be
reported as being in arrears.
KCF-305 Credit cards that have been Closing your credit cards can show you are responsible when it comes to
closed credit, which can help your credit score, rather than hurt it.
KCF-306 Existing home loans or home You have a home loan, or have applied for one, which is good for your credit
loan applications score, it makes you a more eligible applicant.
KCF-307 Unsecured personal loans Because unsecured personal loans are not secured by an asset, they are
considered higher risk for lenders and can negatively impact your credit
score. Try to limit your unsecured personal loans.
KCF-308 Consumer payment defaults A credit provider has report you have a consumer payment default debt of
at least $150 that is overdue by 60 days or more. To avoid defaults, make
payments as soon as your credit provider asks.
KCF-309 Applying for short-term credit Applying for short-term low value credit and loans, can be an indicator that
and loans you may be in financial stress and lower your credit score. Avoid applying
for short-term loans and credit.
KCF-310 Applying for Buy Now Pay Later When applying to Buy Now Pay Later’ (BNPL) services, an ‘enquiry’ can be
services made on your account, leaving a mark on your credit file. Frequent use of
BNPL could suggest you may be in financial stress.
KCF-311 Rare or infrequent credit or loan When you apply for credit, an ‘enquiry’ is carried out and an enquiry is left
applications on your credit file. Having fewer enquiries over a longer period, makes you
appear as a more responsible borrower.
KCF-312 Multiple applications for loans or You have made lots of applications in a short period through several lenders
credit in a short period which negatively impacts your score as you look more desperate for credit.
Try limiting your credit applications.
KCF-313 Applying for better types of The types of credit and lenders are important to your score. Continue to
credit or lenders apply for secured credit applications (where you offer up an asset as
collateral) and from large banks or auto financers
KCF-314 Applying for lesser types of credit The types of credit and lenders are important to your score. Avoid applying
or lenders for too many unsecured credit accounts and using non-bank lenders, as
these can lower your credit score.
126
KCF-315 Long credit history The longer your credit history, the better it is for your score. Aim for a long
track record of credit accounts, such as long-held credit cards and long
lender relationships, without major slip-ups.
KCF-316 Short credit history Lenders want to see if you can handle debt before they give you any. Having
a shorter than average credit history doesn't provide enough evidence. Try
to gradually build up a credit file.
KCF-317 Lower credit profile of your The credit profile of the area you live in can influence your score. Your area
residential area has a lower credit profile, this could mean you are more likely to miss
repayments and are a higher risk to lenders.
KCF-318 Good credit profile of your The credit profile of the area you live in can influence your score. As your
residential area area has a good credit profile, it could mean you are more likely to make
repayments and are less of a risk to lenders.
KCF-319 Infrequent applications for You rarely or infrequently make credit or loan applications for business
commercial credit or loans purposes. This indicates you are a lower risk to lenders, which can help your
credit score.
KCF-320 Frequent applications for You've made loan applications for business purposes with multiple lenders
commercial credit or loans or within a short period, this suggests you're a higher risk. Aim to reduce
the number or spread out applications over time.
KCF-321 Long and stable company You have been a company director for a long period, which is viewed
directorship positively and can help your credit score.
KCF-322 New or changes to Company New or changes to directorships can indicate you are a risk to lenders and
Directorship drive down your credit score. Previous directorship information will stay on
your file for up to 10 years.
KCF-323 Commercial credit payment You have defaults on your credit file from business credit, which has driven
defaults down your credit score. Aim to pay the defaults as soon as possible.
KCF-324 Commercial default & disq You have a commercial credit default and have a disqualified directorship or
director or company in ext admin directorship of a company in external administration.
KCF-325 Your Directorship status You were disqualified as a company director, or are a director of a company
in external administration which negatively impacts your credit score.
KCF-326 Stable employment and Stable employment and residence can indicate you are more reliable. If
residence you've been living and working in one place for a long time, it's better for
your credit score.
KCF-327 Recent household or Moving homes or jobs can indicate that you are a higher risk, impacting
employment changes your score.
KCF-328 Strong credit history You have a long credit history with up to date payments and no defaults,
demonstrating to lenders that you’re likely to be able to repay debts over
the long haul. This is great for your credit score.
KCF-329 Frequent or recent unsecured More frequent or recent unsecured loan applications (not secured by an
loan applications asset) can negatively impact your credit score. Try to spread out your
unsecured loan enquiries.
KCF-330 Fewer unsecured loan Fewer than average unsecured loan applications is a positive for your credit
applications score, as it indicates that you are more responsible with credit and
therefore a lower risk.
KCF-333 Few credit applications to When you apply for a post-paid mobile phone or internet contract, you are
phone/internet providers applying for credit. Fewer than average credit applications to
telecommunication providers can help your credit score.
KCF-334 Frequent credit applications to When you apply for a post-paid mobile phone or internet contract, you are
phone/internet providers applying for credit. Frequent applications to these providers can hurt your
credit score. Aim to spread these out over time.
KCF-335 Few or infrequent applications Every time you apply for credit cards, loans, etc, the lender puts an enquiry
for credit or loans on your credit file. If you have fewer enquiries, it indicates you are more
responsible with debt and helps your score.
KCF-336 Frequent applications for credit Every time you apply for credit, the provider puts an enquiry on your credit
or loans file. Frequent enquiries or from more than 3 different lenders can hurt your
score. Aim to spread out applications.
127
KCF-337 Stable employment and You have been at your residence for a long period of time and have been in
residence stable employment. Lenders consider this as an indicator of lower risk.
KCF-338 Recent household or Moving homes or jobs can indicate that you are a higher risk, impacting
employment changes your score.
KCF-339 Change of name multiple times Changing your name if you marry (for example) will not impact your credit
score. However, if you have 3 or more names on your credit file, it can
indicate that you are a higher risk to creditors.
KCF-340 Long credit history The longer your credit history, the better it is for your score. Aim for a long
track record of credit accounts, such as long-held credit cards and long
lender relationships, without major slip-ups.
KCF-341 Lack of credit history available Lenders want to see your credit history. As you don’t have any credit
accounts or applications, this may negatively impact your score. Try to
gradually build up your credit file.
KCF-342 Less serious default, including Some defaults are less serious than others, including paid defaults, older
paid and smaller amounts defaults and for smaller amounts. If paid, your credit report will still list the
default, but it will show you've paid it.
KCF-343 More serious default, including Some defaults are more serious than others, including unpaid defaults,
unpaid and larger amounts more recent defaults and those for larger amounts. Aim to pay off overdue
debts as soon as possible.
KCF-344 Mortgage Applications Applying for residential property loans is an indicator of being in a good
credit position which is good for your credit score.
KCF-345 Better Area Profile The profile of the area you live in can make a difference to your score. If it
has a better demographic profile, it indicates you are more likely to make on
time repayments and are a lower risk.
KCF-346 Lesser Area Profile The profile of the area you live in can make a difference to your score. If it
has a lower demographic profile, it indicates you are more likely to miss
repayments and are a higher risk to lenders.
The following Key Contributing Factors can be returned in the case of a special score scenario
KCF-351 Exclusion - Bankruptcy Bankrupt (excluding Discharged, Part X, Part IX) as at time of enquiry.
KCF-352 Exclusion - Part X Personal Part X Personal Insolvency Agreement (excluding Discharged and
Insolvency Agreement Terminated) as at time of enquiry.
KCF-353 Exclusion - Part IX Debt Part IX Debt Agreement (excluding Discharged and Terminated) as at time of
Agreement enquiry.
KCF-354 Exclusion - Discharged Discharged Bankrupt (excluding Part X, and Part IX) as at time of enquiry.
Bankruptcy
KCF-355 Exclusion - Part X Personal Part X Personal Insolvency Agreement Discharged as at time of enquiry.
Insolvency Agreement
Discharged
KCF-356 Exclusion - Part IX Debt Part IX Debt Agreement Discharged as at time of enquiry.
Agreement Discharged
KCF-357 Exclusion - Part X Personal Part X Personal Insolvency Agreement Terminated as at time of enquiry.
Insolvency Agreement
Terminated
KCF-358 Exclusion - Part IX Debt Part IX Debt Agreement Terminated as at time of enquiry.
Agreement Terminated
KCF-359 Exclusion - Deceased At least 1 report has flagged the individual as deceased at time of enquiry.
KCF-360 Exclusion - Individual is under 18 Individual is under 18 on their primary file.
KCF-361 Exclusion - Lack of Credit There is not enough Credit Information to provide an Equifax One Score at
Information this time.
128
8.12.7 KCF for One Score for Telco
129
KCF-427 Recent Credit Card Enquiries No recent credit card enquiries may indicate lower credit risk. Negative
KCF-428 Recent Telco Enquiries Recent Telco enquiries may indicate higher credit risk Negative
KCF-429 Recent Telco Enquiries No recent Telco enquiries may indicate lower credit risk. Negative
Low Ratio of Secured Credit A lower ratio of secured to unsecured credit enquiries may indicate Negative
KCF-430 Enquiry higher credit risk.
High Ratio of Secured Credit A higher ratio of secured to unsecured credit enquiries may indicate Negative
KCF-431 Enquiry lower credit risk.
The use of short-term low-value credit facilities may indicate higher Negative
KCF-432 Short Term Credit Enquiries credit risk.
No use of short-term low-value credit facilities may indicate lower Negative
KCF-433 No Short Term Enquiry credit risk.
A higher volume of small-amount credit enquiries may indicate higher Negative
KCF-434 More Small Amount Enquiry credit risk.
Less or No Small Amount A low volume of small-amount credit enquiries may indicate lower Negative
KCF-435 Enquiry credit risk.
KCF-436 More recent residence A recent change of residence may indicate higher credit risk. Negative
KCF-437 Longer residence Stability of residence can indicate lower credit risk. Negative
KCF-438 More Telco Credit Enquiries A higher volume of Telco enquiries may indicate higher credit risk. Negative
KCF-439 Few Telco Credit Enquiries A low volume of Telco enquiries may indicate lower credit risk. Negative
The type of lenders and type of credit enquiries may be an indicator of Negative
KCF-440 Lesser Type of Credit Enquiries higher credit risk
The type of lenders and type of credit enquiries may be an indicator of Negative
KCF-441 Better Type of Credit Enquiries lower credit risk
More Frequent Unsecured The amount and volume of unsecured credit enquiries may indicate Negative
KCF-442 Enquiries higher credit risk.
Less Frequent Unsecured The amount and volume of unsecured credit enquiries may indicate Negative
KCF-443 Enquiries lower credit risk.
Applicant details contain information which may indicate lower credit Negative
KCF-445 Applicant Details risk.
Application details contain information which may indicate lower Negative
KCF-447 Application Details credit risk.
Lower Credit Profile of Higher credit risk is associated with the geodemographic profile of Negative
KCF-448 Residential Area this residential locality.
Higher Credit Profile of Lower credit risk is associated with the geodemographic profile of this Negative
KCF-449 Residential Area residential locality.
KCF-450 More recent residence A recent change of residence may indicate higher credit risk. Negative
KCF-451 Longer residence A stable residence may indicate lower credit risk. Negative
KCF-453 Strong Credit History No arrears or defaults may indicate lower credit risk. Negative
Applicant details contain information which may indicate lower credit Negative
KCF-455 Applicant Details risk.
KCF-456 Lower Credit Profile of Higher credit risk is associated with the geodemographic profile of Negative
130
Residential Area this residential locality.
Higher Credit Profile of Lower credit risk is associated with the geodemographic profile of this Negative
KCF-457 Residential Area residential locality.
KCF-458 Lack of Credit History Available Limited credit history may indicate higher credit risk. Negative
Frequent Commercial Credit Negative
KCF-460 Enquiries Frequent commercial credit enquiries may indicate higher credit risk.
Infrequent Commercial Credit Negative
KCF-461 Enquiries Infrequent commercial credit enquiries may indicate lower credit risk.
External administration or Director of a company in External Administration or disqualified Negative
KCF-462 disqualified directorships directorships may indicate higher credit risk.
KCF-466 Previous Directorships Previous directorships can have an impact on credit risk. Negative
KCF-468 Recent Commercial Default Recent commercial default may indicate higher credit risk. Negative
KCF-469 Early Commercial Default No recent commercial default is an indication of lower credit risk. Negative
The age of a current or previous credit account may indicate a lower Partial
KCF-471 Age of Credit Account credit risk.
The age of a current or previous Telco account may indicate a lower Partial
KCF-473 Age of Telco Account credit risk.
Occurence of non-mortgage Occurence of non-mortgage credit limit increase may indicate a higher Partial
KCF-474 credit limit increase credit risk.
Occurence of non-mortgage Occurence of non-mortgage credit limit decrease may indicate a lower Partial
KCF-475 credit limit decrease credit risk.
The conversion of past credit applications to opened loans may have Partial
KCF-478 Credit Enquiry Conversion an impact on credit risk.
The conversion of past credit applications to opened loans may have Partial
KCF-479 Better Credit Enquiry Conversion an impact on credit risk.
The following Key Contributing Factors can be returned in the case of a special score scenario
KCF-351 Exclusion - Bankruptcy Bankrupt (excluding Discharged, Part X, Part IX) as at time of enquiry. Negative
Exclusion - Part X Personal Part X Personal Insolvency Agreement (excluding Discharged and Negative
KCF-352 Insolvency Agreement Terminated) as at time of enquiry.
Exclusion - Part IX Debt Part IX Debt Agreement (excluding Discharged and Terminated) as at Negative
KCF-353 Agreement time of enquiry.
Exclusion - Discharged Discharged Bankrupt (excluding Part X, and Part IX) as at time of Negative
KCF-354 Bankruptcy enquiry.
Exclusion - Part X Personal Negative
Insolvency Agreement Part X Personal Insolvency Agreement Discharged as at time of
KCF-355 Discharged enquiry.
Exclusion - Part IX Debt Negative
KCF-356 Agreement Discharged Part IX Debt Agreement Discharged as at time of enquiry.
Exclusion - Part X Personal Negative
Insolvency Agreement Part X Personal Insolvency Agreement Terminated as at time of
KCF-357 Terminated enquiry.
KCF-358 Exclusion - Part IX Debt Part IX Debt Agreement Terminated as at time of enquiry. Negative
131
Agreement Terminated
At least 1 report has flagged the individual as deceased at time of Negative
KCF-359 Exclusion - Deceased enquiry.
KCF-360 Exclusion - Individual is under 18 Individual is under 18 on their primary file. Negative
Exclusion - Lack of Credit There is not enough Credit Information to provide an Equifax One Negative
KCF-361 Information Score at this time.
132
YX Commercial+Consumer
Y Commercial
8.19 Relationship
Relationship Code Table
Code Description
1 Principal’s Account (sole) or Principal’s Account
(Sole/Joint) *
2 Principal’s Account (joint)
3 Guarantor
4 Director
For commercial credit only
*Account relationship codes loaded via CCR Data Supply do not differentiate between Principal’s Account sole and Principal’s
Account joint, so they are all loaded as Relationship code 1 and therefore should be treated as Principal’s Account (sole/joint).
For Enquiries or Defaults loaded via legacy systems Relationship code 1 means Principal’s Account (sole) and Relationship
code 2 means Principal’s Account (joint) - see mapping table below:
Enquiries and Defaults via Legacy systems Accounts and Defaults loaded via Data Supply
1 – Principal’s Account (sole) 1 – Principal’s Account (sole or joint borrower)
2 – Principal’s Account (joint) 1 – Principal’s Account (sole or joint borrower)
3 – Guarantor 2 – Guarantor
4 – Director
For commercial credit only
133
0 (zero) The consumer credit is not overdue – Current up to and including the grace period
1 Up to 29 days overdue (after the grace period has been applied)
2 30 – 59 days overdue
3 60 – 89 days overdue
4 90 – 119 days overdue
5 120 – 149 days overdue
6 150 – 179 days overdue
X 180 + days overdue
When no repayment data is available for a specific period, Equifax will return a special value depending on the case.
C Closed
The account is closed, was closed during that period or was not opened yet during that period
A Not associated*
The account is open but the subject of the report is not associated to the account
R Not reported
Repayment data was not reported for this period
P Pending
Repayment data has not been reported yet for this period (applies if the repayment period is the current
month or the month preceding the enquiry)
T Transferred
Account transferred to another credit provider
O (letter) Future Use Only
Allowed Repayment History values in the case of a Temporary relief or deferral financial hardship arrangement (code A)
as specified by the Australian Credit Reporting Data Standards (ACRDS)
0 (zero) No amounts due under the temporary relief or deferral FHA remain unpaid for the RHI-FHI Period (regardless
of whether payments due under the terms of the credit contract remain unpaid). No Grace Period applies
1 An amount due under the temporary relief or deferral FHA remains unpaid for the RHI-FHI Period
*Financial Hardship Information is returned separately to Repayment History Status. An “A” value returned in
Repayment History Status will always mean Not Associated.
134
8.23 Court Type
Court Type Table
Small Court
County Court
District Court
Local Court
Magistrates Court
Supreme Court
8.24.1 Equifax Apply, Equifax One Score and Equifax Commercial Apply
One Score Equifax Apply and Equifax Commercial Apply Special Score Values
Special Score Equifax Apply and Equifax Commercial Apply Equifax One Score Description
Value Description
-903 Customer has a Customer has Bankruptcy or Insolvency on file
1. Bankruptcy or Insolvency on file whether whether discharged or annulled or not
discharged or annulled or not
or
2. 90+ days past due on repayment history in the
current month of scoring
e.g. insolvency, current worst payment status 4+
-902 Deceased/Unknown/ not applicable Deceased/Unknown / not applicable
Not enough information - Credit Inactive with no
Geocodable address
-901 System/internal error (very unlikely) System/internal error (very unlikely)
8.26 State
State Code Table
Code Description
ACT Australian Capital Territory
NSW New South Wales
NT Northern Territory
NZ New Zealand
135
OS Overseas (except Other States or Territories of Australia or New Zealand)
OTH Other State or Territory of Australia (Norfolk Island, Australian Antarctic Territory, Jervis Bay, …)
QLD Queensland
SA South Australia
TAS Tasmania
VIC Victoria
WA Western Australia
136
CRES Crescent GLEN Glen PL Place SDNG Siding
137
8.31 Term of Loan Unit Type
Unit Term Type Code Table
Code Description
Days Days
Weeks Weeks
Months Months
Years Years
138
9 Examples
Sample request and response XML messages are included in this documentation package. The intentions of these
samples are to illustrate the interactions and possible data variations when using the Equifax Apply WSDL. Note
that these are samples only and do not contain complete sets of data.
9.1 Request
1. equifax-apply-sample-request-2.0.6
This is a sample request where we have used the applicant’s personal details and requested two scores;
Equifax Apply Consumer+Commercial Negative and Equifax Apply Consumer+Commercial Comprehensive.
2. equifax-commercial-apply-individual-sample-request-2.0.6
This is a sample request where we have used the applicant’s personal details and requested the Equifax
Commercial Apply Commercial+ Consumer Comprehensive score.
3. Sample-request-by-id-2.0.6
This is a sample request by enquiry ID. You must have a valid enquiry ID from a previous transaction in order
to retrieve responses in this way.
4. equifax-apply -sample-request-telco-2.0.6
This is a sample request where we have used the applicant’s personal details and requested two scores;
VedaScore 1.1 Consumer+Commercial and Equifax Apply (Telco) Consumer+Commercial Negative.
5. equifax-apply -sample-request-utility-2.0.6
This is a sample request where we have used the applicant’s personal details and requested the Equifax Apply
(Utility) Consumer+Commercial Negative score.
6. equifax-apply -sample-request-alternative-lender-2.0.6
This is a sample request where we have used the applicant’s personal details and requested the Equifax Apply
(Alternative Lending) Consumer+Commercial Negative score.
7. equifax-apply-sample-request-guarantor-2.0.6
This is a sample request where we have used the guarantor’s personal details and requested two scores;
VedaScore 1.1 Consumer+Commercial and Equifax Apply Consumer+Commercial Comprehensive.
8. equifax-apply-with-trading-history-sample-request-2.0.6
This is a sample request where we have used the applicant’s personal details and requested two scores;
Equifax Apply Consumer+Commercial Negative and Equifax Apply Consumer+Commercial Comprehensive
AND requested trading history information for the businesses and companies related to the individual.
9. equifax-apply-sample-request-with One score-2.0.6
This is a sample request where we have used the applicant’s personal details and requested two scores (One
Score and Equifax Apply Negative Score) for permission type consumer plus commercial.
139
9.2 Response
1. sample-ban-response-2.0.6
This is a sample response in the event that the individual has placed a File Ban on their record in the Bureau.
2. sample-error-response-2.0.6
This is a sample response in the event that some error has occurred during product fulfilment. In this case, the
requestor has requested an invalid product data level associated to their subscriber settings.
3. sample-async-ticket-response-2.0.6
This is a sample response in the event where the requestor had used an asynchronous operation.
4. sample-sync-ticket-response-2.0.6
This is a sample response in the event where the requestor had used a synchronous operation however for
some reason the system was not able to complete the request within the service response window.
5. equifax-apply-sample-full-response-2.0.6
This is a sample response to a request for credit information on an applicant with permission type
Consumer+Commercial (XY). This response illustrates several product features including:
⮚ Consumer credit information with FIR and sample data across all element levels
⮚ Commercial credit information with FIR and sample data across all element levels
⮚ Public credit information with FIR and sample data across all element levels
⮚ Consumer credit information with FIR and sample data across all element levels
⮚ Commercial credit information with FIR and sample data across all element levels
⮚ Public credit information with FIR and sample data across all element levels
140
This is a sample response to an Equifax Apply (Telco) request for credit information on an applicant with
permission type Consumer+Commercial (XY). This response illustrates several product features including:
⮚ Consumer credit information with FIR and sample data across all element levels
⮚ Commercial credit information with FIR and sample data across all element levels
⮚ Public credit information with FIR and sample data across all element levels
⮚ Consumer credit information with FIR and sample data across all element levels
⮚ Commercial credit information with FIR and sample data across all element levels
⮚ Public credit information with FIR and sample data across all element levels
⮚ Consumer credit information with FIR and sample data across all element levels
⮚ Commercial credit information with FIR and sample data across all element levels
⮚ Public credit information with FIR and sample data across all element levels
⮚ Genesis Data BlockTM and Alternative Lending Data Block (Negative characteristics)
⮚ Comprehensive consumer credit information with FIR and sample data across all element levels
⮚ Commercial credit information with FIR and sample data across all element levels
141
⮚ Public credit information with FIR and sample data across all element levels
13. equifax-apply-with-trading-history-sample-response-2.0.6
This is a sample response to requesting trading history information. This response illustrates how the
individual trading history information is returned in the report.
14. equifax-apply-sample-full response-with-One Score-2.0.6
This is a sample response with the One Score. This response illustrates how the Equifax One Score is returned
in the report on an applicant with permission type Consumer+Commercial (XY). This response illustrates
several product features including:
142
2. Appendix A –Tips for Matching to Individual Bureau Files
The ability to retrieve and match the subject of an enquiry is dependent on the amount and integrity of identity
data provided. Obviously, the better the quality and quantity of identity data provided, the higher the probability
that the bureau is able to retrieve and match the subject of enquiry and the better the credit decision can be.
As Name and Date of Birth are not unique including additional identifiers can ensure the optimal matching results
are obtained. Include previous residential addresses, date of birth, gender, Australian Driver’s Licence number,
middle name and employer name.
2.2.1.4 other-given-name Supply the middle name, if provided as this also increases match
rate – there are fewer John Michael Smith than John Smith
2.2.4.1.3 property
2.2.4.1.4 unit-number
2.2.4.1.5 street-number
2.2.4.1.6 street-name Ensure the street type does not appear here e.g. “Phillip” not
“Phillip St”
2.2.4.1.7 street-type Valid Street types only
2.2.4.1.8 suburb Ensure the suburb is correct for the postcode
2.2.4.1.9 state
2.2.4.1.10 post-code Ensure the postcode is correct for the suburb
2.2.5 drivers-licence Always include a driver’s licence number, when available, it is very
important for matching
2.2.8 employer Always supply employer as this can increase your match rate.
If the subject of the enquiry has moved in the last 3 years, it is recommended that both current
and previous addresses are provided. If the subject has resided in another state/territory, enter
this as the previous residential address, regardless of timeframe.
143
Example: An individual moves from Victoria to Queensland and 6 months later applies for credit. They have a
new address and a new driver’s licence, that are not stored on the Equifax Bureau and name and date of birth are
not unique so no definite match can be found. Supplying the previous address in Victoria provides a link to the
existing file and the details are matched and updated.
144
3. Appendix B –Tips for entering Driver Licence Number
Australian Driver’s Licence Number is an important identifier when matching to individual bureau files. However,
an incorrectly typed driver licence in an Equifax Apply request results in an error, impacting your completion rates
and match rates.
Equifax highly recommends customers to provide the following restrictions into the Online Form/User Interface
during driver licence’s entry:
● Length of the driver licence is minimum 4, maximum 9 characters
● Valid characters are Alpha and Numeric
● No special characters or blanks/spaces
● Must have at least 4 numeric characters.
● Must have no more than 2 alpha characters.
● The third and fourth characters must be numeric.
Also, Equifax analysed common error patterns and to facilitate correct processing of a request recommends the
following tips for entering Driver’s Licence Numbers.
a) Do not enter card number instead of the licence number for New South Wales Driver Licence
When submitting licence number from an NSW Driver Licence, please do not provide the card number instead of
the licence number. The figure below illustrates where the card number and licence number are placed in the
licence. The card number is 11 digits (XX XXX XXX XXX), placed at the top right corner. The licence number is
placed just below the address and has 9 digits.
145
. Full Stop
@ At Sign
( Left Parenthesis
) Right Parenthesis
* Asterix
If the individual does not have an Australian Driver’s Licence, please leave the driver’s licence field blank. Any
other input in this scenario would lead to an error. Some common inputs that have resulted in errors are:
INPUT
N/A or n/a
Don’t Have One
An Overseas Driver Licence Number
Individual’s Name
Name of another country
Do not enter a licence number that has spaces in between the digits, this will result in an error.
For example, ‘129 129 129’ in an incorrect input and ‘129129129’ is the correct input.
Only the licence number needs to be provided. If you prefix the state before the licence number this becomes a
valid response.
For example, NSW123456 is an invalid input and 123456 is a valid input.
146
4. Appendix C –Hybrid & Asynchronous Ticket Response Testing
The Customer Testing Area (CTA) provides a dedicated endpoint for customers to test and validate their
integration against a fully-functional instance of the Equifax Apply web service:
https://ctaau.apiconnect.equifax.com.au/cta/sys2/soap11/vedascore-apply-v2-0
In addition to the standard functionality, this endpoint also enables customers to simulate particular scenarios,
e.g. ticket responses. These scenarios can be triggered by assigning a specific value to the <operator-name>
element in the <enquiry-header> section of the XML request payload.
…
<vs:enquiry-header>
<vs:client-reference>MY-REF-101</vs:client-reference>
<vs:operator-id>101</vs:operator-id>
<vs:operator-name>test-hybrid-success</vs:operator-name>
<vs:permission-type-code>XY</vs:permission-type-code>
<vs:product-data-level-code>C</vs:product-data-level-code>
<vs:requested-scores>
<vs:scorecard-id>VSA_2.0_XY_NR</vs:scorecard-id>
<vs:scorecard-id>VSA_2.0_XY_CR</vs:scorecard-id>
</vs:requested-scores>
</vs:enquiry-header>
…
In the above example, the test-hybrid-success value is used to trigger a “ticket” scenario, where the service returns
an enquiry-id rather than a full report, thus simulating the event of the service switching from synchronous to
asynchronous delivery. The caller should then be able to use the enquiry ID returned in the ticket response to
retrieve the report by calling the retrieveEnquiryByID operation on the same service end point.
The following table describes the test scenarios supported by the CTA endpoint:
147