Page Comparison

What are expanded responses? 

Expanded responses are a DVS initiative to provide more information about an individual’s document verification outcome. An expanded response is a brief explanation provided by the document issuer, on why the individual's information did not match the document being verified. The purpose of expanded responses is to assist you in making more informed decisions when assessing verification outcomes.    

For example, if an individual provides their driver licence for verification but fails to enter their middle name, the match will error and a brief response will be provided:

Document type: Driver Licence

Document field: First Name

DVS Expanded Response: First name does not match  

What are the limitations of expanded responses?

There are some limitations to the data provided in the expanded response, these include:

1. Not all document issuers are providing expanded responses. See details here.

2. Only one expanded response will be returned per document. This means if there are several matching errors only one will be explained. See details here.

3. Expanded responses are returned as a free text field, controlled by the document issuers, and may change without notice.

4. There is no unique code associated with each response.

5. Note that DVS are still in the process of reviewing the responses they get back from their various document issuers.

Where will Expanded Responses be available in greenID?

Expanded responses will be returned:

• In the API results (sample below)

• In Audit Logs via greenID Admin Panel (see below)

When will expanded responses be available in greenID?

Expanded responses are returned in the API results (sample below) now.

Expanded responses will be available in Admin Panel Audit Logs on the following dates:

Environment

Availability

Test

28th April 2023

Production

10th May 2023

How do I get to Expanded Responses in the Audit Logs?

The Audit Logs are accessed via the greenID Admin Panel, by clicking the ‘Audit Logs’ button from the ‘Verification Results’ screen:

What will expanded responses look like in the Audit Logs?

The Expanded Responses will be displayed in a new Audit Log entry, which will appear following the existing entry that shows the DVS data source result. These will be available for both interactive data source checks and background data source checks. The entry will include which data source the Expanded Response is for, the verification request number for the check, and the ‘expanded response’ message returned by the DVS for the check.

If the DVS do not return an Expanded Response for a data source check, then there will be no Expanded Response audit log entry displayed for that check.

The below is an example of the Expanded Response audit log entry for an interactive source check for the ACT Driver’s Licence:

Image Removed

Image Added

How do expanded responses appear in my API results?

Below are samples where an expanded response result has been sent in the extra data section.

Method	Source	Response
setFields	Visa
setFields	Marriage Certificate
setFields	Birth Certificate
registerVerification	NSW DL
registerVerification	ACT DL
registerVerification	ACT DL
registerVerification	Passport

How do expanded responses impact my API results?

Expanded responses are sent in the ‘Extra Data’ section of the API results and therefore should not impact your integration with greenID. You can review and make changes to your workflow (as necessary) to utilise expanded responses in your business process.

Which versions of the API return Expanded Responses?

Expanded Response will be returned in version 2 onwards. Version 1 of the greenID API does not support this feature.

Do expanded responses impact verification workflows in greenID?

No, expanded responses do not impact workflows. They are only be returned as extra data or additional information associated with a DVS data source outcome.

What are the expanded response messages?

For a full list of messages please see below.

IMPORTANT: This is a DVS list, is not definitive and may change without notice. We will update this as DVS advise.

Last update from DVS 01 Oct 2022.

What message is returned in the event of a MAPS lockout?

We are seeing the response Document Temporarily Locked for MAPS lockouts.

How many responses are returned?

DVS will return only one response per document to provide guidance without providing a level of information that could assist fraud. Multiple attempts of a document validation will be prevented by the MAPS functionality.

This means that if multiple fields provided do not match fields held by the document issuer, only one of the un-matched fields will be flagged by expanded response.

e.g:

There is no specified field order in which the messages will be returned.

Does this mean I won’t have to contact DVS to explain why my document has failed?

In some cases it should help narrow down the reason why a document has failed, however there will be cases where DVS can provide more details.

Which DVS document issuers are returning expanded responses?

The below table shows which documents provide expanded responses. Last update from DVS 07/03/ 31 Aug 2023 .

IMPORTANT: This is a DVS list, may not be definitive and may change without notice, we will update as changes are advised by DVS.

How can I use expanded responses?

The purpose of expanded responses is to provide greater insight into why the data provided did not match the data held by the document issuer. The data could be used to assist with assessment of failed identity verifications. Note the limitations of expanded responses here.

Glossary 

Document Issuer - The government body who issues the document, e.g. the Australian Passport Office issues passports, the various state and territory Roads Authorities issue Driver Licences. 

DVS - Document Verification Service, the government agency who centralises and manages the connection to the various document issuers for the purpose of identity verification.