Reading the result

1 · Check the application completed

application.status === "complete"

Value	Meaning
incomplete	Created, not submitted. No verification has happened.
complete	Submitted. Results are meaningful.
expired	The form expired unsubmitted.

Nothing below is meaningful until this holds — before then other_status.ekyc may read pending or even pass while nothing has been captured.

2 · Read the results from extra

extra carries what the verification actually produced. Prefer it over the status columns: statuses are summaries, and every column except ekyc is configured per workspace.

extra.ekyc.face_compare      selfie against the document portrait
extra.ekyc.liveness          the liveness capture and its attempts
extra.ekyc.identity_document the document scan
extra.identity_aml           screening results, when the flow runs them

face_compare is the shortcut

If extra.ekyc.face_compare is present, the liveness check and the document scan both succeeded — the comparison could not have run otherwise. One field tells you all three worked.

extra.ekyc.face_compare.status   "match", "need_review" or "not_match"
extra.ekyc.face_compare.score    0–100 similarity

score sets status, and other_status.ekyc follows it:

score	face_compare.status	other_status.ekyc
70 or above	match	pass
61–69	need_review	need_review
60 or below	not_match	fail

need_review means both checks passed but the faces were not a confident match — route it to a person rather than treating it as either outcome.

Full field detail: extra.ekyc.

3 · Check the document is in date

answers.date_of_expiry.value

Compare against the submission date, not today, if you are reprocessing historical applications.

Screening results

Flows with a screening step also return extra.identity_aml. Its aggregate verdict:

extra.identity_aml.comply_advantage[0].result

Flag	Matched against
is_any_in_sanctions	Sanctions lists
is_any_in_pep	Politically exposed persons
is_any_in_warnings	Regulator and law-enforcement warning lists
is_any_in_adverse_media	Adverse media
is_any_in_fitness_probity	Fitness-and-probity registers

How each maps to your own decision is a policy matter. UpPass reports; you decide.

Note

The object is omitted when no screening step ran — which is not the same as a clean result.

Next

The webhook payloadEvery field these checks refer to, fully specified, with downloadable examples.