For each verification attempt, you can retrieve all scores in the transaction returned from verification services. The metaData endpoint, /environments/{{envID}}/users/{{userID}}/verifyTransactions/{{transactionID}}/metaData, receives all requests for scores associated with the verification attempt and returned from verification services.

Only those with an Identity Data Admin role are permitted to use the metaData endpoint.

Verification metadata data model {#verify-verification-metadata-data-model}

Property Type Required? Mutable? Description
type String N/A Read-only The type of metadata in the object; can be: LIVENESS, FACIAL_COMPARISON, or DOCUMENT_AUTHENTICATION
provider String N/A Read-only The provider of metadata in the object; can be: AMAZON, MITEK, or IDRND.
data Object N/A Read-only Verificaton metadata for type = LIVENESS and provider = IDRND, type = FACIAL_COMPARISON and provider = AMAZON, and type = DOCUMENT_AUTHENTICATION and provider = MITEK

data object for type = LIVENESS and provider = IDRND {#verify-data-object-for-type-liveness-and-provider-idrnd}

Property Type Required? Mutable? Description
score Double N/A Read-only A decimal number that represents the raw liveness score; a higher value means more alive
quality Double N/A Read-only A decimal number between 0 and 1 that represents the quality of the image
probability Double N/A Read-only A decimal number between 0 and 1 that represents the liveness probability of the image

data object for type = FACIAL_COMPARISON and provider = AMAZON {#verify-data-object-for-type-facial_comparison-and-provider-amazon}

Property Type Required? Mutable? Description
similarity Double N/A Read-only A decimal number between 0 and 100 that represents the level of confidence that the faces match
confidence Double N/A Read-only A decimal number between 0 and 100 that represents the level of confidence that the image contains a face
quality.
brightness
Double N/A Read-only A decimal number between 0 and 100 that represents the brightness of the face; a higher value indicates a brighter face image
quality.
sharpness
Double N/A Read-only A decimal number between 0 and 100 that represents the sharpness of the face; a higher value indicates a sharper face image

data object for type = DOCUMENT_AUTHENTICATION and provider = MITEK {#verify-data-object-for-type-document_authentication-and-provider-mitek}

Property Type Required? Mutable? Description
frontImageDocumentId String N/A Read-only A UUID that is referenced in mitekVerifications object to determine the image the verification ran on
backImageDocumentId String N/A Read-only A UUID that is referenced in mitekVerifications object to determine the image the verification ran on
documentEvidenceId String N/A Read-only A UUID that is referenced in mitekVerifications object to determine the image the verification ran on
mitekVerifications Object N/A Read-only Verification results object
mitekVerifications.
name
String N/A Read-only Nme of the authenticator (test)
mitekVerifications.
judgement
String N/A Read-only Overall determination of the authenticity of the dossier based on the evidence presented. Permitted values are: Authentic, Fraudulent, and Undetermined.
mitekVerifications.
verificationType
Integer N/A Read-only A 3-digit number (code) that indicates the type of authenticator
mitekVerifications.
probability
Integer N/A Read-only A number that represents the overall authenticity score used in determining the authenticity of the dossier.
mitekVerifications.
version
String N/A Read-only Version of the individual authenticator
mitekVerifications.
documentId
String N/A Read-only A UUID of the image the verification ran on
mitekVerifications.
notifications
Object N/A Read-only An object of any number of key-value pairs, where the key is a notification code and the value is its description, in the event an authenticator was unable to run