ScreenlyyIDDocs
Docs › Data and results

Data retrieval

The output of an API call comes from the ScreenlyyID decision engine: an automated evaluation mechanism that helps reduce fraud and improves the customer experience in non-assisted enrolments. The engine evaluates several logical units, called trust factors.

When the end user completes the enrolment, you can request the data from it:

  • Data: the OCR and MRZ data extracted from the document.
  • Decision results: a verification score and trust factor scores for the document, plus the face match and liveness results.
  • Images: images taken during onboarding, such as the document photo and extracted portrait.

Decision results#

The decision results contain these properties:

PropertyDescription
verificationsA list of trust factor scores, each as a key and value pair.
decisionThe main output of the whole process, containing a score and level pair.
livenessResultThe result of the passive liveness check: Live, Not Live or Poor Quality.
faceMatchResultThe result of matching the selfie to the document photo. IsMatch is true or false.

For more on the data in these results, read Understanding results.

Endpoints#

For the standard identity verification flow, see Get OCR data, Get decision results and Document image download. If you use the hosted SDK, see Hosted SDK data.