Querying the Outcome of a Verification Process

After the verification process is complete, the outcome must be securely queried from greenID. 

RESTful Web Service

The simplest way to query the outcome is to use the RESTful web service provided by greenID. The web service can be invoked by performing a HTTP GET against the base URL being used plus “/df/verificationResult” with the following query parameters:

  • 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.

An example request is: https://simpleui-test-au.vixverify.com/df/verificationResult?accountId=xxxyyyy&webServicePassword=zzzz&verificationToken=914d98541cdc5e08ed0bdb3187b3edc93395b9de 
OR another example https://simpleui-uat1.vixverify.com/df/verificationResult?accountId=xxxyyyy&webServicePassword=zzzz&verificationToken=914d98541cdc5e08ed0bdb3187b3edc93395b9de

The web service will return a JSON fragment with all the details of the person and the overall status of the verification attempt. See Verification Result Variables for a list of the variables and explanations for each of them.

WSDL Web Service

Whilst using our RESTful webservice is the easiest method to integrate for simple integrations, it does not return as much detail about a verification attempt. If your usage scenario requires more detail you may need to integrate using our greenID API web service. Information on how to integrate using greenID API in general is available on the Version 3 greenID API page. For information on how to get the results for a verification attempt made through the GreenID Mobile SDK please take a look at the GetVerificationResult section of the Web Method Details V3 page.