Report V1

Here is an example of a report for an onboarding consisting in selfie, spanish ID and passport.

Selfie	ID ESP	Passport

Warning

Please bear in mind that the selfie is not from a real person. That is why the face_liveness score is low.

Structure

A user’s report is given as a JSON. The following sub-sections detail the corresponding JSON schemas to help a better understanding of the report.

A report collects all the information extracted for a user during the onboarding process
type	object
properties
created_at	Report creation time in ISO 8601 format
	type	string
	format	date-time
documents	It collects all user documents
	type	array
	items	Document Report
events	It collects all user events
	type	array
	items	User Event
id	Unique report identifier (UUID v4 standard)
	type	string
	maxLength	36
	minLength	36
other_trusted_documents	It collects all user Other Trusted Document. An OTD is a PDF containing a proof of residence, a payroll, a proof of address…
	type	array
	items	OTD Report
selfies	It collects all user selfies
	type	array
	items	Selfie Report
summary	User summary
	allOf	Report Summary
user_id	Unique user identifier (UUID v4 standard)
	type	string
	maxLength	36
	minLength	36
version	Report version
	type	integer
	const	1

Report summary

Report Summary

It summarizes the main user information of the onboarding process
type	object
properties
checks	Summary/User-level checks
	type	array
	default
	items	Check
devices	Devices operated by the user
	type	array
	default
	items	Device
external_user_data	External UserData
face_liveness	Analysis to detect if the user’s active selfie is from a real person. The recommended threshold is 50.
	type	number
	maximum	100
	minimum	0
face_matching	All available face matchings between user’s seflies and docs
	type	array
	default
	items	Face Matching
user_data	Best read user-intrinsic info across all docs
	type	array
	default
	items	Document Field

External UserData

It collects the given data at user creation time
type	object
properties
email	type	string
first_name	type	string
last_name	type	string

Selfie reports

Selfie Report

A selfie report collects all the information extracted for a selfie during the onboarding process
type	object
properties
checks	Selfie-level checks
	type	array
	default
	items	Check
created_at	Selfie creation time in ISO 8601 format
	type	string
	format	date-time
id	Unique selfie identifier (UUID v4 standard)
	type	string
	maxLength	36
	minLength	36
liveness	Analysis to detect if the selfie is from a real person. The recommended threshold is 50.
	type	number
	maximum	100
	minimum	0
media	Selfie media resources
	type	object
	additionalProperties	Href
number_of_faces	Number of faces appearing in the selfie
	type	number
voided	Whether the selfie has been voided or not
	type	boolean

Document reports

Document Report

A document report collects all the information extracted for a document during the onboarding process
type	object
properties
checks	Document-level checks
	type	array
	default
	items	Check
created_at	Document creation time in ISO 8601 format
	type	string
	format	date-time
id	Unique document identifier (UUID v4 standard)
	type	string
	maxLength	36
	minLength	36
meta	Document Report Meta
sides	default	back	null
		front	null
		internal	null
	allOf	Document Sides Detail Report
summary_fields	Best-read document info from all its sides
	type	array
	default
	items	Document Field

Document Report Meta

It collects document metadata
type	object
properties
completed	True if all document sides are captured
	type	boolean
issuing_country	Document issuing country in ISO 3166-1 alpha-3 format
	type	string
type	Document Type
voided	Whether the doc has been voided or not
	type	boolean

Document Sides Detail Report

type	object
properties
back	Document Side Report
front	Document Side Report
internal	Document Side Report

Document Side Report

It collects document metadata
type	object
properties
fields	Document info extracted from side
	type	array
	default
	items	Document Field
media	Document side media resources
	type	object
	additionalProperties	Href
meta	Document Side Report Meta
side	Side

Document Side Report Meta

It collects document side metadata
type	object
properties
manual	True if the capture was taken in manual mode
	type	boolean
template	Document version used to extract the info
	type	string

Side

An enumeration.
enum	front, back, internal

Document Type

An enumeration.
enum	idcard, driverlicense, residencepermit, passport, healthinsurancecard

OTD reports

OTD Report

An OTD report collects all the information of a previously added OTD
type	object
properties
created_at	OTD creation time in ISO 8601 format
	type	string
	format	date-time
id	Unique OTD identifier (UUID v4 standard)
	type	string
	maxLength	36
	minLength	36
media	type	object
	properties
	pdf	Href
meta	OTD Report Meta

OTD Report Meta

It collects OTD metadata
type	object
properties
category	External identifier (e.g: Proof of residence)
	type	string
voided	Whether the OTD has been voided or not
	type	boolean

User events

User Event

It collects events info
type	object
properties
attributes	type	object
device	Device on which the event occurred
	allOf	Device
id	Unique event identifier (UUID v4 standard)
	type	string
	format	uuid
occurred_on	Event time in ISO 8601 format
	type	string
	format	date-time
type	Event type
	type	string

Common structures

Face Matching

It analyses whether the document’s face and selfie are from the same person
type	object
properties
meta	Face Matching Meta
score	Face matching score. The recommended threshold is 50.
	type	number
	maximum	100
	minimum	0

Face Matching Meta

Face matching metadata
type	object
properties
created_at	Face match creation time in ISO 8601 format
	type	string
	format	date-time
document_id	Unique document identifier (UUID v4 standard)
	type	string
	maxLength	36
	minLength	36
selfie_id	Unique selfie identifier (UUID v4 standard)
	type	string
	maxLength	36
	minLength	36
side	Document side
	allOf	Side

Document Field

It collects the extracted OCR info
type	object
properties
checks	type	array
	default
	items	Check
name	type	string
score	type	integer
value	type	string

Check

It examines if a certain condition is met
type	object
properties
detail	Brief check description
	type	string
key	Unique check identifier
	type	string
value	this is the value of the check
	type	number
	maximum	100
	minimum	0

See Checks

Device

It collects info about a device
type	object
properties
agent	Alice SDK
	type	string
agent_version	Alice SDK version
	type	string
ip	type	string
model	type	string
platform	type	string
platform_version	type	string

Href

It collects info about a media resource
type	object
properties
extension	Media extension
	type	string
	default	null
href	HTML-like href link
	type	string
objects	Identified regions
	type	object
	default	null
	additionalProperties	Bounding Box

Bounding Box

A bounding box is the smallest rectangle with vertical and horizontal sides that completely surrounds an object
type	object
properties
height	Rectangle height
	type	integer
width	Rectangle width
	type	integer
x	Top left corner x coordinate
	type	integer
y	Top left corner y coordinate
	type	integer

Checks

Alice Report V1 offers you different checks to help you building your use case logic.

All checks range from 0 to 100 with threshold at 50.

• Values greater than or equal to 50 mean that the check has passed.

• Values ​​below 50 mean that the check has failed.

Summary-level checks

These are the checks at user level. They can be found at summary > checks.

name	Detail
only_one_device_check	All information has been uploaded by the user with the same device
only_one_ip_check	All information has been uploaded by the user with the same ip

Selfie-level checks

These are the checks at selfie level. They can be found at selfies > checks.

Name	Detail
liveness	The selfie is from a real person
only_one_face	Only one face detected in the selfie

Document-level checks

These are the checks at document level. They can be found at documents > checks.

Warning

The checklist may be different depending on the document type and/or issuing country. Therefore, the absence of a certain check should never be a reason for rejection. This only means that there is not enough evidence in the document to compute it.

Name	Detail
checked_info_code	The document’s MRZ/PDF417/QR is checked
coherent_document_dates	The document dates are coherent with each other
consistent_document	There are less than 3 inconsistent fields between the document sides
expected_document	Read and selected documents match
face_in_front_side	The document contains a face in its front side
face_matching	The document and active selfie faces are from the same person
not_a_printed_document	The document is not a print
not_a_screen_document	The document’s pictures are not taken from a screen
not_a_synthetic_document	The document’s pictures are not digitally generated
uncompromised_document	The document has not been found in our internal database of compromised documents
unexpired_document	The document has not expired

Field-level checks

These are the checks at field level. They can be found at:

• summary > user_data > checks

• documents > summary_fields > checks

• documents > sides > front/back/internal > fields > checks

Warning

The checklist may be different depending on the field. Therefore, the absence of a certain check should never be a reason for rejection. It only means that there is not enough evidence in the field to compute it.

Name	Detail	Comments
checked_field	The field passes its checksum
expected_field	The field matches what is expected
complete_mrz_name	Name is entirely contained in MRZ
consistent_field	The same field has the same value in other doc or side
over_18	Over 18 years old	Only applicable to birth_date field
unexpired_date	Date has not expired	Only applicable to expiration_date field
valid_date_format	Valid date format	Applicable to fields ending with _date
valid_date_range	Date is within valid range	Applicable to fields ending with _date