Evidence

Evidence Capsule

An Evidence Capsule is a structured JSON snapshot of a screening decision: the original input, normalized query, match rationale, source metadata, engine version, and decision hash.

Retrievable audit evidence for every decision

Retrieve the full Evidence Capsule for a screening decision by its capsule ID.

bash

curl https://api.verifex.dev/v1/evidence-capsules/9f2a4c7e1b3d5a8c \
  -H "Authorization: Bearer vfx_your_api_key"

Each capsule records

evidence_capsule_id
verdict + risk_score + identity_confidence
source_type + source_severity + source_freshness_hours
original_input + normalised_query
match_rationale (diagnostic compatibility evidence)
engine_version + list_version
decision_hash (SHA-256, deterministic)
recommended_action + human_review_required

Evidence Capsules support audit review and regulatory inquiry. They are not legal advice, regulatory approval, or final compliance determinations.

Evidence durability states

Whether a screening's evidence capsule is retrievable now, still landing, genuinely missing, or predates capsules entirely. Retry logic depends on telling these apart.

State	Means	Action
`DURABLE`	The decision record and evidence capsule are persisted and retrievable.	No action
`PENDING`	The screening completed and its evidence is still being written. This is not an audit gap; check again shortly.	No action
`UNAVAILABLE`	No durable evidence exists and the persistence window has elapsed. This is a permanent gap and needs operator repair.	Operator repair required: a real audit gap
`HISTORICAL_UNKNOWN`	This screening predates Evidence Capsules. None was ever created, so its absence is not a missing record.	No action

Info

A successful evidence-required response never precedes durable evidence: PENDING means retry shortly, while UNAVAILABLE means the capsule should exist and does not, and retrying will not produce it.