• accountId – the customer’s greenID account ID.  Issued by greenID.
• webServicePassword – the customer’s web service password, note that this is not the same as the apiCode.
• verificationToken – identifies which verification session to fetch the result for.  Note that the verificationToken must be current, and therefore this action must be performed within 30 minutes of the person completing the verification session, otherwise the verificationId must be used.
• verificationId – if the verificationToken for a user has expired and the verificationId is known, then this can be used to identify the user to fetch the result for.

Only one of the verificationToken or verificationId is required; if both are provided then verificationId is used.

Please note that if greenID Web is being run against the test environment, i.e. the environment parameter is set to "test" in the setup function, then the outcome must be queried from the greenID Web test server, which is simpleui-test-au.vixverify.com.

There are two ways to get the verificationToken: 

1. From the form that was submitted when the verification session completed.  When the form is finally allowed to submit, greenID Web will add a hidden input field called "verificationToken" to the form.
2. When the sessionCompleteCallback function is invoked, the verificationToken is passed as a parameter.

An example request for the Australian production environment is below:

https://simpleui-au.vixverify.com/df/verificationResult?accountId=greenid-simpleui&webServicePassword=password&verificationToken=914d98541cdc5e08ed0bdb3187b3edc93395b9de

Similarly, an example request that will query the outcome from the Australian test SimpleUI environment is:

The US endpoints are illustrated in these examples:

Examples of requests

Australian production environment:

https://simpleui-

au.vixverify.com/df/verificationResult?accountId=

greenidsimpleui&webServicePassword=password&verificationToken=914d98541cdc5e08ed0bdb3187b3edc93395b9de

https://simpleui-test-

au.vixverify.com/df/verificationResult?accountId=greenid-simpleui&webServicePassword=password&verificationToken=914d98541cdc5e08ed0bdb3187b3edc93395b9de

Fields Returned

The web service will return a JSON fragment with all the details of the person and the overall status of the verification attempt.  The following fields are returned:

• error – indicates if an error was encountered; normally this will be “false”.
• errorMessage – contains an error message if the error element is “true”.  If there was no error, then this element will be absent from the JSON fragment.
• verificationResult – the overall state of the verification attempt.
• verificationId – the unique identifier for this verification attempt (note that this is different from the verification token, which identifies a single session related to the verification attempt).
• verificationToken – an echo of the verificationToken passed to the web service.
• givenName – the given name that was registered.  This field may be blank.
• middleNames – the middle names that were registered.  This field may be blank.
• surname – the surname that was registered.
• email – the email that was registered.  This field may be blank.
• dob – the date of birth that was registered.
• homePhone – the home phone number that was registered.  This field may be blank.
• workPhone – the work phone number that was registered.  This field may be blank.
• mobilePhone – the mobile phone number that was registered.  This field may be blank.
• flatNumber – the flat number that was registered.  This field may be blank.
• streetNumber – the street number that was registered.   This field may be blank.
• streetType – the street type that was registered.  This field may be blank.
• suburb – the suburb that was registered.  This field may be blank.
• state – the state that was registered.  This field may be blank.
• postcode – the postcode that was registered.  This field may be blank.
• country – the country that was registered.  This field may be blank.