Skip to content
HCC Buddy home

F12.988 ICD-10-CM Code: Cannabis use, unspecified with other cannabis-induced disorder

F12.988 maps to CMS-HCC V28 137. A source-labeled RAF reference is available. Confirm the documented diagnosis and applicable coding requirements. MEAT criteria · RAF Calculator · HCC Buddy coding tools

ICD-10-CM Code View

HCC Buddy Code Card

Digital ICD-10 code-book layout with official code detail, always-visible risk models, Code Trumping, and Buddy coding guidance.

Code lookupF12.988

FY 2026 Apr update / Mental, Behavioral and Neurodevelopmental disorders (F01-F99) / Mental and behavioral disorders due to psychoactive substance use (F10-F19)

F12.988

Billable / SpecificICD-10-CMOfficial ICD-10-CMCodebook guidance

Cannabis use, unspecified with other cannabis-induced disorder

A person uses cannabis in an unspecified pattern and has developed another cannabis-related health problem, such as cannabis hyperemesis syndrome or other specified disorder.

Buddy the Bee presenting code insight

Buddy Insight

Cannabis use, unspecified with other cannabis-induced disorder captures specific cannabis-related complications not classified elsewhere, such as cannabis hyperemesis syndrome, when the severity of the use disorder is not documented.

OverviewRisk ModelsCode BookDocumentationAuditNotesEdition comparison

CMS-HCC V28

HCC 137

Coefficient HCC 137: 0.424 (Community Non-Dual Aged (CNA))

CMS-HCC V24

Historical

Historical

Not used for CY2026 payment

ACA/HHS

HCC 082

Code-level coefficient reference

ESRD/PACE

HCC 55

Code-level coefficient reference

RXHCC

N/A

—

Not mapped

Code Book Path

Official
F12.9Cannabis use, unspecifiedF12.98Cannabis use, unspecified with other cannabis-induced disorderF12.988Cannabis use, unspecified with other cannabis-induced disorder

Inclusion Terms

Official
  • Cannabis induced sleep disorder, without use disorder

Excludes 2

Official
  • symptoms, signs and abnormal clinical laboratory findings, not elsewhere classified (R00-R99)Inherited from F01-F99

Related Codes

Official
F12.980Cannabis use, unspecified with anxiety disorder

Includes

Official
  • disorders of psychological developmentInherited from F01-F99, F12
  • marijuanaInherited from F01-F99, F12

Excludes 1

Official
  • cannabis abuse (F12.1-)Inherited from F12.9
  • cannabis dependence (F12.2-)Inherited from F12.9

Code First

Official

No Code First sequencing instructions are included in this display for F12.988. Check the code and parent instructions in the Code Book.

Use Additional

Official

No Use Additional Code instructions are included in this display for F12.988. Check the code and parent instructions in the Code Book.

Code Also

Official

No Code Also instructions are included in this display for F12.988. Check the code and parent instructions in the Code Book.

Buddy Documentation Tip

HCC Buddy guidance
Documentation of cannabis use
Description of the specific cannabis-induced disorder (name and characterize)
Causal link between cannabis use and the disorder
Clinical evidence supporting the diagnosis

MEAT Support

HCC Buddy guidance
Documentation of cannabis use
Description of the specific cannabis-induced disorder (name and characterize)
Causal link between cannabis use and the disorder
Clinical evidence supporting the diagnosis

Audit Caution

HCC Buddy guidance
Using a more general vomiting or gastrointestinal code when cannabis hyperemesis syndrome is documented
Not querying for the severity of the cannabis use disorder
Confusing this with F12.99 (unspecified disorder) — this code requires identifying a specific condition
Failing to document the specific nature of the induced disorder

Common Mistakes

HCC Buddy guidance
F12.980 — Cannabis use, unspecified with anxiety disorder; use when anxiety is the specific disorder
F12.99 — Cannabis use, unspecified with unspecified cannabis-induced disorder; use only when the disorder cannot be identified
F12.188 — Cannabis abuse with other cannabis-induced disorder; use when abuse is documented
R11.10 — Vomiting, unspecified; do not use when vomiting is attributable to cannabis hyperemesis syndrome

Current with CMS: FY2026 ICD-10-CM Apr 1 update (effective Apr 1 – Sep 30, 2026) · CMS-HCC V28, 100% phased in for payment year 2026. FY2027 code set already staged for October 1, 2026. How HCC Buddy stays current →

Is F12.988 an HCC code?

Yes. F12.988 (Cannabis use, unspecified with other cannabis-induced disorder) maps to HCC 137, Drug Use Disorder, Moderate/Severe, or Drug Use with Non-Psychotic Complications under the CMS-HCC V28 risk adjustment model, with a source-labeled community non-dual aged reference coefficient of 0.424. Source-labeled code-level coefficients are references, not member totals. Actual contribution depends on complete member context, hierarchy and cleanup rules, interactions, and model year. HCC Buddy's RAF Calculator supports CMS-HCC V28 PY2026 and shows no score unless every required source and calculation check passes. It is billable for payment year 2026.

Coder answer: F12.988 is billable and maps to V28 HCC 137, Drug Use Disorder, Moderate/Severe, or Drug Use with Non-Psychotic Complications. Open it in the Code Book for the tabular path, RAF, and MEAT checklist.

Code
F12.988
Description
Cannabis use, unspecified with other cannabis-induced disorder
HCC (V28)
HCC 137 — Drug Use Disorder, Moderate/Severe, or Drug Use with Non-Psychotic Complications
RAF reference coefficient
0.424
Billable
Yes
Payment year
2026

HCC Category Mapping

V28HCC 137, Drug Use Disorder, Moderate/Severe, or Drug Use with Non-Psychotic Complications
0.424
ESRDHCC 55, Substance Use Disorder/Moderate/Severe/Substance Use with Complications
Not separately weighted

These are source-labeled model coefficients, not member totals. A category may still be removed by hierarchy or model cleanup rules. Weights are not directly comparable across models: CMS-HCC V28 and V24 use Community, Non-Dual, Aged; ESRD uses the dialysis continuing-enrollee model; RxHCC is the Part D continuing-enrollee, non-low-income, aged weight (a larger scale than CMS-HCC). ACA/HHS has no single weight — it varies by metal level. Actual per-patient RAF contribution depends on member context, hierarchy and cleanup rules, interactions, and the model year used by the payer. V28 is the CMS-HCC model phased in over payment years 2024–2026; V24 remains available for historical review.

Work F12.988 in the Code Book — tabular path, V28 RAF reference, and MEAT checklist →

MEAT review for F12.988

For F12.988, confirm that the documentation supports the diagnosis and meets the applicable coding, encounter, program and payer requirements. MEAT (Monitor, Evaluate, Assess, or Treat) is a review mnemonic, not a universal CMS coding rule.

  • MMonitor: signs, symptoms, disease progression, or lab trending documented in the note
  • EEvaluate: test results, medication response, or physical findings reviewed by the provider
  • AAssess: explicit mention in the assessment or plan with acknowledgment of status
  • TTreat: medication, referral, procedure, therapy, or counseling tied to the diagnosis

Coder workflow notes

Get the V28 mapping + MEAT cheat sheet

One printable reference: check representative V28 mappings and the documentation reminders your note needs. Free, no card.

Free PDF. No card. Unsubscribe anytime.

What This Code Means

F12.988 is the ICD-10-CM diagnosis code for cannabis use, unspecified with other cannabis-induced disorder. A person uses cannabis in an unspecified pattern and has developed another cannabis-related health problem, such as cannabis hyperemesis syndrome or other specified disorder. F12.988 sits in the ICD-10-CM chapter for mental, behavioral and neurodevelopmental disorders (f01-f99), within the section covering mental and behavioral disorders due to psychoactive substance use (f10-f19).

Under the CMS-HCC V28 risk adjustment model, F12.988 maps to Drug Use Disorder, Moderate/Severe, or Drug Use with Non-Psychotic Complications (HCC 137) with a source-labeled community, non-dual, aged reference coefficient of 0.424. For CY2026 non-PACE Medicare Advantage, CMS uses 100% of the 2024 CMS-HCC model (V28). PACE uses a separate model blend. Source-labeled code-level coefficients are references, not member totals. Actual contribution depends on complete member context, hierarchy and cleanup rules, interactions, and model year. HCC Buddy's RAF Calculator supports CMS-HCC V28 PY2026 and shows no score unless every required source and calculation check passes.

Use this code when documentation specifies a particular cannabis-induced disorder not captured by other F12 codes. For F12.988, confirm that the documentation supports the diagnosis and meets the applicable coding, encounter, program and payer requirements. MEAT (Monitor, Evaluate, Assess, or Treat) is a review mnemonic, not a universal CMS coding rule. When documentation is ambiguous, coders should issue a provider query rather than assume the highest-specificity variant.

HCC Buddy maintains structured V28 and V24 mapping, source-labeled coefficient references, and MEAT documentation criteria for F12.988 sourced directly from the CMS-HCC risk adjustment model files and the CMS ICD-10-CM code set.

Coding Tips

  • •Use this code when documentation specifies a particular cannabis-induced disorder not captured by other F12 codes
  • •Review clinical notes for the specific disorder induced by cannabis use to ensure accurate coding

Clinical Significance

Cannabis use, unspecified with other cannabis-induced disorder captures specific cannabis-related complications not classified elsewhere, such as cannabis hyperemesis syndrome, when the severity of the use disorder is not documented. Cannabis hyperemesis syndrome has become increasingly recognized as cannabis potency has increased and is characterized by cyclic vomiting, nausea, and compulsive hot water bathing. Documenting these conditions ensures comprehensive clinical care and appropriate risk adjustment.

Documentation Requirements

  • ✓Documentation of cannabis use
  • ✓Description of the specific cannabis-induced disorder (name and characterize)
  • ✓Causal link between cannabis use and the disorder
  • ✓Clinical evidence supporting the diagnosis
  • ✓Exclusion of other potential causes for the disorder
  • ✓Confirmation that the disorder does not fit anxiety, psychosis, or sleep disorder categories

Commonly Confused Codes

  • •F12.980: Cannabis use, unspecified with anxiety disorder; use when anxiety is the specific disorder
  • •F12.99: Cannabis use, unspecified with unspecified cannabis-induced disorder; use only when the disorder cannot be identified
  • •F12.188: Cannabis abuse with other cannabis-induced disorder; use when abuse is documented
  • •R11.10: Vomiting, unspecified; do not use when vomiting is attributable to cannabis hyperemesis syndrome

Child Codes

F12.980Cannabis use, unspecified with anxiety disorder
HCC 137
F12.988Cannabis use, unspecified with other cannabis-induced disorder
HCC 137

Code Hierarchy

└F12Cannabis related disorders└F12.9Cannabis use, unspecified└F12.98Cannabis use, unspecified with other cannabis-induced disorder└F12.988Cannabis use, unspecified with other cannabis-induced disorder
└F12.988Cannabis use, unspecified with other cannabis-induced disorder

Also searched as

  • F12 988
  • F12988

For F12.988, confirm that the documentation supports the diagnosis and meets the applicable coding, encounter, program and payer requirements. MEAT (Monitor, Evaluate, Assess, or Treat) is a review mnemonic, not a universal CMS coding rule.

F12.988 maps to CMS-HCC V28 category 137, Drug Use Disorder, Moderate/Severe, or Drug Use with Non-Psychotic Complications. See the ICD-10 to HCC mapping hub for how the V28 crosswalk works. The mapping identifies a payment HCC category for F12.988. Review its source-labeled HCC coefficient above, check the RAF Calculator with complete member context for CMS-HCC V28 PY2026, and confirm the documentation the chart needs before the code is submitted. HCC Buddy shows no RAF score unless every required source and calculation check passes.

Work F12.988 in HCC Buddy

Open F12.988 in the Code Book for the full Index-to-Tabular path, MEAT checklist, and V28 HCC mapping, or in the Encoder to code from a keyword search. Pro includes 7 days to try everything, no card required.

Open in Code BookOpen in EncoderStart Pro