Sign in
latestOpenAPI 3.1.0Proprietary - UrbanFox2026-08-101443106.2 KB

e99fd9028c60

Cases

Get a case

Retrieve full details for a single fraud case.

get/v2/{tenant_slug}/cases/{case_id}

Path parameters

tenant_slugstring required

Tenant DNS slug (lowercase letters, digits, and hyphens; 3-100 characters).

Example:demo-retail

Tenant DNS slug (lowercase letters, digits, and hyphens; 3-100 characters).

case_idstring required

Unique case identifier returned by GET /cases.

Example:case-abc123

Unique case identifier returned by GET /cases.

Response

Successful Response

Example response

{
  "data": {
    "case_id": "case-abc123",
    "tenant_id": "00000000-0000-4000-8000-000000000000",
    "website_account_id": "account-abc123",
    "session_id": "a1b2c3d4-20240115-103500000",
    "unique_id": "8f1e2d3c-4b5a-6978-8a9b-0c1d2e3f4a5b",
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-15T14:20:00Z",
    "current_state": {
      "state_id": "7a54d2a4-5e2f-4b72-9a4a-3276b4af0c11",
      "score": 4,
      "changed_at": "2024-01-15T10:35:00Z",
      "changed_by": "system",
      "reason": "Case created from model prediction"
    },
    "state_history": [
      {
        "case_status": "OPEN",
        "changed_at": "2024-01-15T10:35:00Z",
        "changed_by": "system",
        "reason": "Case created from model prediction",
        "score": 4,
        "session_status": "ACTIVE",
        "state_id": "7a54d2a4-5e2f-4b72-9a4a-3276b4af0c11"
      }
    ],
    "details": {
      "overall_risk_score": 3,
      "fraud_labels": [
        "Account Takeover",
        "Bot"
      ],
      "summary": "Account takeover attempt detected from suspicious IP",
      "highlights": [
        "Multiple failed login attempts",
        "IP from high-risk country"
      ]
    },
    "fraud_occurrences": {
      "15e341ed-6dae-4783-8647-32a7b7a8269a": {
        "explanation": {
          "fraud_reason": "High velocity account creation",
          "fraud_reason_description": "The account was created very fast and may indicate a bot was used.",
          "fraud_types": [
            "Bot Creation"
          ],
          "model_behaviour": [
            {
              "model_name": "bos_session_aggregate_classifier",
              "top_contributors": [
                {
                  "alignment": "supporting",
                  "description": "Total number of events in the session",
                  "direction": "toward_fraud",
                  "direction_specific": "increases_BotActor_probability",
                  "feature": "total_event_count",
                  "feature_value": 30,
                  "impact_level": "critical",
                  "plain_name": "Total Event Count",
                  "shap_value": 1.151
                }
              ],
              "type": "shap"
            }
          ]
        },
        "generated_at": "2024-01-15T10:35:00Z",
        "occurrence_id": "15e341ed-6dae-4783-8647-32a7b7a8269a",
        "prediction_id": "pred_a1b2c3d4-20240115-103500000_2024-01-15T10:35:00Z",
        "risk_score": 4,
        "session_id": "a1b2c3d4-20240115-103500000"
      }
    }
  }
}