Skip to main content

User Risk Taxonomy

Classification system for detecting user mental health and safety risks. Used by the Screen and Evaluate APIs.

Other taxonomies: AI Behavior | Services

Screen vs Evaluate

Both endpoints detect all 9 risk types. The difference is depth of assessment.

FieldScreenEvaluate
Risk type (9 types)
Severity
Imminence
Subject attribution
Evidence features (180+)
Protective factors
Legal flags (IPV, safeguarding, stalking)
Communication styles
Recommended reply

Screen is optimized for real-time triage ($0.001/call). Evaluate provides clinical-grade assessment ($0.05/call).

Key Concept: Subject × Type

NOPE separates WHO is at risk (Subject) from WHAT the risk is (Type). This enables clean detection of scenarios like:

  • "I want to hurt myself" → subject: self, type: self_harm
  • "My friend is suicidal" → subject: other, type: suicide
  • "He hit me again" → subject: self, type: abuse (speaker is victim)

Risk Subjects (WHO)

Who is at risk in this conversation?

Self

self

The speaker is at risk

"I want to hurt myself"

Other

other

Someone else is at risk

"My friend is suicidal", "He hit her"

Unknown

unknown

Cannot determine subject with confidence

Ambiguous scenarios

Risk Types (WHAT)

What type of harm is present? These are harm-based categories, not domain-specific.

TypeDescription
suicideSelf-directed lethal intent - thoughts, plans, or attempts to end one's life
self_harmNon-suicidal self-injury (NSSI) - intentional self-harm without intent to die
self_neglectSelf-care failure and psychiatric emergency - eating disorders, psychosis, substance crisis, severe functional impairment, medical care refusal
violenceRisk of harm to others - threats, plans, or acts of violence
abusePhysical, emotional, sexual, or financial abuse patterns
sexual_violenceRape, sexual assault, or sexual coercion
neglectFailure to care for dependents - children, elderly, vulnerable adults
exploitationTrafficking, labor exploitation, sextortion, grooming
stalkingPersistent unwanted contact, following, surveillance

Communication Styles (HOW)

How is the content expressed? Orthogonal to risk level — the same crisis content can be expressed directly, through humor, via creative writing, etc.

Evaluate endpoint only — Screen does not return communication style analysis.

StyleDescription
directExplicit, first-person present statements ("I want to die")
humorDark humor, memes, ironic expressions, Gen-Z speak
fictionCreative writing, roleplay, storytelling contexts
hypothetical"What if" scenarios, "asking for a friend"
distancedThird-party concern, temporal distancing, past tense
clinicalAcademic, professional, research discussion
minimizedHedged language, downplaying severity
adversarialJailbreak attempts, manipulation, testing boundaries

Severity Scale

How serious is the risk? Severity determines the urgency of intervention.

LevelDescription
noneNo clinical concern
mildMinor distress, no functional impairment
moderateClear concern, not immediately dangerous
highSerious risk requiring urgent intervention
criticalLife-threatening, imminent harm

Imminence Scale

How soon might harm occur? Imminence helps prioritize response timing.

LevelDescription
not_applicableOnly when severity = none
chronicWeeks-months, stable pattern
subacuteLikely escalation in days-weeks
urgentEscalation likely within 24-48h
emergencyHappening NOW

Evidence Features & Protective Factors

Features are atomic, observable indicators from a universal feature pool (not domain-specific).

Evaluate endpoint only — Screen returns the basics above (risk type, severity, imminence, subject) without granular features.

FeatureDescription
passive_ideationWish to be dead, "better off without me" - no active thoughts of method
active_ideationActive thoughts about self-harm or suicide
intent_statedExplicit statement of intent to act on thoughts
plan_presentSpecific method or plan identified
timeline_statedSpecific timeframe mentioned (e.g., "this weekend")
method_seekingActively researching methods, locations, or lethality
preparatory_actsGoodbye letters, giving away possessions, stockpiling means
active_attemptAttempt currently in progress or just occurred
interrupted_attemptAttempt stopped by external factor
aborted_attemptSelf-stopped attempt before completion
previous_attemptsHistory of past suicide attempts

123 total features across 14 categories.

Clinical Frameworks

NOPE's taxonomy is informed by established clinical risk assessment frameworks:

FrameworkUsage
C-SSRSSuicide severity (ideation features)
HCR-20Violence risk (violence features)
STARTProtective factors, cross-cutting
DASHIPV risk assessment (abuse features)
Danger AssessmentIPV lethality (strangulation indicator)
SAMStalking assessment (stalking features)

For request/response examples, see the API Reference.