Skip to main content

Resolving Cases

Case resolution documents the outcome of an investigation and creates an audit trail for compliance purposes.

Resolution Process​

Resolve a Case​

curl -X POST https://api.bytrustgate.com/v1/cases/{case_id}/resolve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "no_action_required",
    "notes": "Confirmed false positive. Name match only - different date of birth and nationality.",
    "supporting_evidence": ["doc_verification_result", "doc_research_notes"]
  }'

Resolution Response​

{
  "id": "case_789012",
  "status": "resolved",
  "resolution": {
    "type": "no_action_required",
    "notes": "Confirmed false positive. Name match only - different date of birth and nationality.",
    "resolved_by": "analyst@company.com",
    "resolved_at": "2025-01-20T16:45:00Z"
  },
  "subject": {
    "type": "applicant",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "John Doe",
    "status": "approved"
  }
}

Resolution Types​

No Action Required​

For false positives and cleared investigations:

curl -X POST https://api.bytrustgate.com/v1/cases/{case_id}/resolve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "no_action_required",
    "notes": "False positive - different individual confirmed through multiple data points.",
    "false_positive_reason": "name_only_match"
  }'

Use when:

  • Screening hit is a false positive
  • Verification issues resolved
  • No compliance concern identified

Approved with Conditions​

For cases requiring ongoing monitoring or restrictions:

curl -X POST https://api.bytrustgate.com/v1/cases/{case_id}/resolve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "approved_with_conditions",
    "notes": "PEP confirmed but low corruption risk. Approved with enhanced monitoring.",
    "conditions": [
      "enhanced_monitoring",
      "annual_review",
      "transaction_limits"
    ],
    "review_date": "2026-01-20"
  }'

Use when:

  • PEP match confirmed
  • Higher risk customer accepted
  • Enhanced due diligence required

Rejected​

For cases resulting in customer rejection:

curl -X POST https://api.bytrustgate.com/v1/cases/{case_id}/resolve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "rejected",
    "notes": "Sanctions match confirmed. Cannot onboard due to OFAC restrictions.",
    "rejection_reason": "sanctions_match",
    "applicant_action": "reject"
  }'

Use when:

  • True sanctions match
  • Fraud confirmed
  • Risk outside appetite

SAR Filed​

For cases resulting in suspicious activity reports:

curl -X POST https://api.bytrustgate.com/v1/cases/{case_id}/resolve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "sar_filed",
    "notes": "SAR filed for suspicious transaction patterns.",
    "sar_reference": "SAR-2025-00123",
    "sar_filed_date": "2025-01-20",
    "filing_jurisdiction": "FinCEN"
  }'

Use when:

  • Suspicious activity identified
  • Regulatory filing required
  • AML concerns substantiated

Referred​

For cases referred to external parties:

curl -X POST https://api.bytrustgate.com/v1/cases/{case_id}/resolve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "referred",
    "notes": "Referred to legal counsel for contract review.",
    "referred_to": "external_legal",
    "reference_number": "LEGAL-2025-456"
  }'

Resolution Summary​

ResolutionApplicant ActionUse Case
no_action_requiredApproveFalse positive, cleared
approved_with_conditionsApprove (flagged)PEP, enhanced DD
rejectedRejectTrue match, unacceptable risk
sar_filedVariesRegulatory filing made
referredHoldExternal party review
account_closedCloseExit existing customer

Hit Resolution​

When resolving screening cases, also resolve the underlying hits:

Resolve as False Positive​

curl -X POST https://api.bytrustgate.com/v1/screening/hits/{hit_id}/resolve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "false_positive",
    "reason": "Different individual - verified via passport DOB mismatch",
    "related_case_id": "case_789012"
  }'

Resolve as True Match​

curl -X POST https://api.bytrustgate.com/v1/screening/hits/{hit_id}/resolve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "true_match",
    "reason": "Confirmed via multiple identifiers",
    "related_case_id": "case_789012"
  }'

Applicant Actions​

Auto-Update Applicant Status​

Configure automatic applicant status updates on case resolution:

curl -X PUT https://api.bytrustgate.com/v1/settings/resolution-actions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rules": [
      {
        "resolution": "no_action_required",
        "case_type": "sanctions",
        "applicant_action": "approve"
      },
      {
        "resolution": "rejected",
        "case_type": "any",
        "applicant_action": "reject"
      },
      {
        "resolution": "approved_with_conditions",
        "applicant_action": "approve",
        "add_flags": ["enhanced_monitoring", "pep"]
      }
    ]
  }'

Manual Applicant Update​

curl -X POST https://api.bytrustgate.com/v1/cases/{case_id}/resolve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution": "rejected",
    "notes": "Fraud confirmed.",
    "applicant_action": {
      "status": "rejected",
      "reason": "fraud_confirmed",
      "block_reapplication": true
    }
  }'

Closing Cases​

After resolution, cases can be closed:

curl -X POST https://api.bytrustgate.com/v1/cases/{case_id}/close \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "final_notes": "Case complete. All documentation archived."
  }'

Reopening Cases​

Closed cases can be reopened if needed:

curl -X POST https://api.bytrustgate.com/v1/cases/{case_id}/reopen \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "New information received requiring additional review.",
    "priority": "high"
  }'

Resolution Audit Trail​

Every resolution creates a complete audit record:

{
  "case_id": "case_789012",
  "audit_trail": {
    "created": {
      "at": "2025-01-20T10:00:00Z",
      "by": "system",
      "trigger": "sanctions_screening_hit"
    },
    "assigned": {
      "at": "2025-01-20T10:01:00Z",
      "to": "analyst@company.com",
      "by": "auto_routing"
    },
    "investigated": {
      "started_at": "2025-01-20T10:30:00Z",
      "notes_count": 3,
      "evidence_count": 2
    },
    "resolved": {
      "at": "2025-01-20T16:45:00Z",
      "by": "analyst@company.com",
      "resolution": "no_action_required",
      "time_to_resolution_hours": 6.75
    },
    "closed": {
      "at": "2025-01-20T17:00:00Z",
      "by": "analyst@company.com"
    }
  }
}

Resolution Metrics​

Track resolution performance:

curl -X GET "https://api.bytrustgate.com/v1/analytics/cases/resolutions?period=30d" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "period": "30d",
  "total_resolved": 245,
  "by_resolution": {
    "no_action_required": 180,
    "approved_with_conditions": 35,
    "rejected": 20,
    "sar_filed": 5,
    "referred": 5
  },
  "avg_time_to_resolution_hours": 18.5,
  "sla_compliance_rate": 0.94,
  "false_positive_rate": 0.73
}

Next Steps​