Report V1

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

Selfie

ID ESP

Passport

selfie

id_front id_back

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