GET
Get a KYC Application

Path Parameters

id
string<uuid>
required

Response

One application

The business-facing view of an application.

Deliberately carries no applicant identity — Dinari does not hold it. What it carries is the decision and enough provenance for the business to justify acting on it.

aml_hit_count
integer<int32>
required
created_at
string<date-time>
required
id
string<uuid>
required
metadata
any
required
reason_codes
any
required
status
enum<string>
required

Where an application is in its life.

Mirrors Verifi's session vocabulary rather than inventing a Dinari one: a translation layer between two enums that mean the same thing is a place for them to drift apart.

Available options:
CREATED,
OPENED,
SUBMITTED,
PROCESSING,
COMPLETED,
EXPIRED,
CANCELED,
FAILED
synced_at
string<date-time>
required

When Dinari last heard from the KYC service about this application.

aml_decision
string | null
client_id
string<uuid> | null
completed_at
string<date-time> | null
decision_summary
string | null
document_expiry
string<date> | null
document_type
string | null
error_message
string | null
external_id
string | null
face_match_outcome
string | null
liveness_outcome
string | null
nationality
string | null
verdict
null | enum<string>

The verdict Verifi reached.

NeedsReview is a first-class outcome, not an absence of one: Verifi never auto-approves a possible AML match, so this is the state a compliance officer is expected to resolve.

Available options:
APPROVED,
NEEDS_REVIEW,
REJECTED