The API response of a transaction contains several parameters which give useful information to the viewer. Here is what they mean:

searchStatus tells us whether or not a particular search was successfully performed. It can either be Successful or UnSuccessful. 

sourceStatus gives us information about the source where the data is sent for verification. A 'Successful' sourceStatus means that the source is in running fine and can be used for identity verification. UnSuccessful essentially means the source is not up and running due to an ongoing maintenance activity or for some other reason. 

For safeHarbour and safeHarbourScore, we have got a detailed article in our Knowledge Base: What is Safe Harbour and Safe Harbour Scoring?

addressMatchScore is a combined score calculated using the result of all address elements. How it's calculated can vary across services.
If all address elements return 'true', addressMatchScore will be 1.000. It will drop if one or more address elements return 'false' and will be 0.000 if all elements are false.

nameMatchScore is an aggregated score by taking into account the result for firstName AND lastName. For a full nameMatchScore, both firstName and lastName must be true. Please also go through the following article for more info: How does Name-Match Scoring work?

identityVerified simply means whether or not a record was found in the database. It's directly linked with the parameter status: identityVerified will be 'true' if the status is 0 or 1 and will be 'false' if it's 2 or 3.

searchErrorMessage only appears when the search fails pre-validation.

errorMessage is the general error message file that will display most of the errors.


In case of a query, please raise a ticket at our Support Portal or connect with us via Live Chat.