Creating Cases

Cases can be created automatically by screening triggers or manually by compliance analysts when investigation is needed.

Automatic Case Creation

Screening Triggers

Cases are automatically created when:

Trigger	Case Type	Priority
Sanctions hit (>80% confidence)	sanctions	Critical
PEP match	pep	High
Fraud signals detected	fraud	High
Document verification failure	verification	Medium
Adverse media hit	adverse_media	Configurable

Configure Auto-Creation

curl -X PUT https://api.bytrustgate.com/api/v1/settings/case-triggers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sanctions_hit": {
      "enabled": true,
      "min_confidence": 80,
      "priority": "critical"
    },
    "pep_match": {
      "enabled": true,
      "priority": "high"
    },
    "adverse_media": {
      "enabled": true,
      "min_risk_score": 70,
      "priority": "medium"
    },
    "verification_failure": {
      "enabled": true,
      "priority": "medium"
    }
  }'

Manual Case Creation

Create Case via API

curl -X POST https://api.bytrustgate.com/api/v1/cases \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "aml",
    "priority": "high",
    "subject_type": "applicant",
    "subject_id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Suspicious transaction pattern",
    "description": "Multiple large transactions to high-risk jurisdictions detected.",
    "tags": ["transaction_monitoring", "high_risk_country"]
  }'

Response

{
  "id": "case_789012",
  "type": "aml",
  "priority": "high",
  "status": "open",
  "subject": {
    "type": "applicant",
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "John Doe"
  },
  "title": "Suspicious transaction pattern",
  "description": "Multiple large transactions to high-risk jurisdictions detected.",
  "tags": ["transaction_monitoring", "high_risk_country"],
  "created_at": "2025-01-20T14:30:00Z",
  "created_by": "user_456"
}

Case Types

Sanctions Case

Created for potential sanctions list matches:

curl -X POST https://api.bytrustgate.com/api/v1/cases \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "sanctions",
    "priority": "critical",
    "subject_type": "applicant",
    "subject_id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "OFAC SDN potential match",
    "related_screening_id": "check_123456"
  }'

PEP Case

Created for politically exposed person matches:

curl -X POST https://api.bytrustgate.com/api/v1/cases \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "pep",
    "priority": "high",
    "subject_type": "applicant",
    "subject_id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "PEP - Government Minister family member",
    "related_screening_id": "check_123456"
  }'

Fraud Case

Created for suspected fraud:

curl -X POST https://api.bytrustgate.com/api/v1/cases \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "fraud",
    "priority": "high",
    "subject_type": "applicant",
    "subject_id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Document manipulation detected",
    "fraud_indicators": ["tampered_document", "face_mismatch"]
  }'

Verification Case

Created for document/identity verification issues:

curl -X POST https://api.bytrustgate.com/api/v1/cases \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "verification",
    "priority": "medium",
    "subject_type": "applicant",
    "subject_id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "Document quality issues",
    "verification_issues": ["blurry_document", "partial_face"]
  }'

Bulk Case Creation

Create multiple cases at once:

curl -X POST https://api.bytrustgate.com/api/v1/cases/bulk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cases": [
      {
        "type": "aml",
        "priority": "medium",
        "subject_type": "applicant",
        "subject_id": "applicant_1",
        "title": "Periodic review required"
      },
      {
        "type": "aml",
        "priority": "medium",
        "subject_type": "applicant",
        "subject_id": "applicant_2",
        "title": "Periodic review required"
      }
    ]
  }'

Case Templates

Create cases from predefined templates:

# Create from template
curl -X POST https://api.bytrustgate.com/api/v1/cases/from-template \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "template_annual_review",
    "subject_type": "applicant",
    "subject_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

Available Templates

Template	Use Case
annual_review	Periodic KYC refresh
adverse_media_alert	News monitoring hit
transaction_review	Unusual transaction
pep_enhanced_dd	Enhanced due diligence for PEPs

Linking Related Entities

Link to Screening Result

{
  "type": "sanctions",
  "subject_id": "applicant_123",
  "related_screening_id": "check_456",
  "related_hit_ids": ["hit_789", "hit_012"]
}

Link to Documents

{
  "type": "verification",
  "subject_id": "applicant_123",
  "related_document_ids": ["doc_456", "doc_789"]
}

Link to Other Cases

{
  "type": "aml",
  "subject_id": "applicant_123",
  "related_case_ids": ["case_previous_1", "case_related_company"]
}

Case Metadata

Add custom metadata to cases:

curl -X POST https://api.bytrustgate.com/api/v1/cases \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "aml",
    "priority": "high",
    "subject_id": "applicant_123",
    "title": "High-value transaction review",
    "metadata": {
      "transaction_amount": 500000,
      "currency": "USD",
      "destination_country": "CY",
      "risk_score": 85
    }
  }'

---

Next Steps

• Case Workflows - Assignment and escalation
• Resolving Cases - Resolution procedures
• AI Assistance - AI-powered investigation help