Response

Reading the result

Every match carries identity confidence, source classification, and a link to the Evidence Capsule.

Example response

json

{
  "query": {
    "name": "Alejandro García López",
    "type": "person",
    "country": "MX",
    "mode": "broad"
  },
  "verdict": "possible_match",
  "risk_level": "medium",
  "risk_score": 62,
  "risk_tier": "review",
  "recommended_action": "review_if_policy_requires",
  "human_review_required": true,
  "total_matches": 1,
  "request_id": "9f2a4c7e1b3d5a8c",
  "screened_at": "2026-05-09T12:00:00.000Z",
  "decision_hash": "sha256:a3f8…c91b",
  "missing_fields": ["date_of_birth"],
  "evidence_capsule_id": "9f2a4c7e1b3d5a8c",
  "evidence_capsule_url": "/v1/evidence-capsules/9f2a4c7e1b3d5a8c",
  "matches": [{
    "id": "match_01hxz…",
    "name": "GARCIA LOPEZ, Alejandro",
    "source": "OFAC",
    "source_type": "sanctions",
    "source_severity": "primary",
    "confidence": 87,
    "match_type": "FUZZY",
    "risk_level": "high",
    "programs": ["SDGT"],
    "aliases": ["GARCIA, A."]
  }]
}

Response fields

source_severity

primary | secondary | pep | watchlist: the regulatory weight of the list.

source_freshness_hours

Hours since the matching source was last successfully synced.

decision_hash

Deterministic SHA-256 derived from input + match + source version.

evidence_capsule_url

URL to retrieve the full Evidence Capsule for audit review.

missing_fields

Fields absent from the query that would increase confidence.

match_type

EXACT | FUZZY | PHONETIC: which matching stage produced the hit.