Behavioral Health H Codes: 15 Codes Explained the Easy Way

Behavioral health H codes are the HCPCS Level II codes most state Medicaid programs use to pay for counseling, crisis care, peer support, psychosocial rehab and substance use programs. They look simple, but small mistakes get these claims denied: the wrong unit count, a missing HO or HQ modifier, an expired authorization, or an H-code sent to a payer that only accepts CPT.

This guide puts the most-used H-codes in one table, explains when to use an H-code instead of a CPT code, shows the 15-minute unit math, and walks through the denials we see most.

What Are Behavioral Health H Codes?

HCPCS has two levels. Level I is the CPT code set from the AMA. Level II is the alphanumeric code set kept by CMS. Inside Level II, the H series covers behavioral health, mental health and alcohol and drug services that CPT doesn’t describe well, such as peer support, psychosocial rehab, residential stays and program-based care.

Here is who uses behavioral health H codes:

• State Medicaid programs (fee-for-service) are the main users. Many state plans define community mental health and substance use benefits with H-codes.
• Medicaid managed care plans follow their state’s code list and often add their own authorization rules.
• State-funded and grant programs (for example, county or state behavioral health authorities) often use H-codes for reporting and payment.
• Some commercial plans accept certain H-codes, mostly for substance use programs. Always check the contract.
• Medicare generally does not pay behavioral health H codes. Medicare behavioral health claims use CPT codes and Medicare G-codes instead.

Behavioral Health H Codes Master Table

These are the behavioral health H codes we see most on claims. The descriptions are summarized from the CMS HCPCS Level II file. The unit column shows what the code descriptor says. Where the descriptor names no unit, your payer decides it.

Summaries are ours. Check the full descriptor in the current CMS HCPCS quarterly file before you build your charge master.

H-Codes vs CPT Codes: Which One Do You Bill?

The same visit can often be described with an H-code or a CPT code. The payer decides which one it accepts, not the clinician. Here is how the most common pairs compare:

Rule of thumb: Medicare and most commercial plans want CPT. State Medicaid and its managed care plans often want H-codes for community, program-based and paraprofessional services. If your clinic bills both, map each service by payer in your billing system. For CPT therapy codes, see our guide to CPT code 90837 and our mental health billing services.

Modifiers Used With H-Codes

Medicaid programs add HCPCS modifiers to behavioral health H codes to show who provided the service, how (individual, group, family) and which program it belongs to. A missing or wrong modifier is one of the fastest ways to get behavioral health H codes denied.

See our behavioral health billing services for full support with Medicaid H-codes, substance use programs, IOP and partial hospitalization claims.

15-Minute Unit Math for Behavioral Health H Codes

Many behavioral health H codes, like H0004, H0038, H2011, H2014, H2017 and H2019, are billed in 15-minute units. The tricky part is the leftover minutes. Payers use one of two methods:

• Midpoint method (8-minute rule). A unit counts once you pass the midpoint, 8 minutes. Medicare uses this for its own timed codes (CMS Claims Processing Manual, Chapter 5). Many Medicaid programs use the same idea for H-codes.
• Full-unit method. Only complete 15-minute blocks count. Some Medicaid programs and plans require this.

Midpoint column follows the unit ranges in CMS Claims Processing Manual, Chapter 5, Section 20.2. Confirm which method your state Medicaid program or plan uses.

Two more rules apply on most Medicaid claims:

• Document start and stop times (or total minutes) in the note. Auditors recount units from the note.
• Don’t add minutes across different codes to reach a unit unless your payer’s manual allows it. 10 minutes of H2014 and 10 minutes of H2017 are not one 20-minute unit of either code.

Step-by-Step: How to Bill an H-Code Claim

1. Check eligibility and the plan. Confirm whether the member is fee-for-service Medicaid or in a managed care plan. The plan decides the code list, modifiers and authorization rules.
2. Confirm the authorization. Many behavioral health H codes (IOP, PHP, residential, rehab services) need prior authorization. Match the code, units and date range on the authorization to what you plan to bill.
3. Match the code to the payer. Use the payer’s crosswalk: H0031 or 90791, H0004 or 90834, and so on. Don’t send H-codes to Medicare.
4. Add the right modifiers. Credential (HM/HN/HO/HP), setting (HQ, HR, HS), program (HA, HF) and telehealth (95) as the payer requires. Put them in the order the payer’s manual shows.
5. Count units from the note. Use the payer’s unit method. Per diem codes are one unit per day.
6. Check the place of service and rendering provider. Make sure the rendering provider is enrolled with the plan and allowed to bill that code.
7. Submit and track. Watch the filing limit (Texas Medicaid is generally 95 days from the date of service) and work any denial quickly.

Worked Example: One IOP Day Plus a Crisis Contact

An adult Medicaid managed care member attends a substance use intensive outpatient program on Tuesday. That evening, a master’s-level clinician provides a 53-minute crisis intervention in the community.

The rates below are sample numbers for the math only. They are not a fee schedule. Use your own state or plan rates.

The math: 53 minutes is 3 full units (45 minutes) plus 8 minutes left over. Under the midpoint method, the 8 leftover minutes count, so you bill 4 units. Under the full-unit method, they don’t, so you bill 3 units. Billing 4 units to a full-unit payer is an overbilling risk. Billing 3 units to a midpoint payer leaves money on the table.

The bundling check: Some plans treat crisis care as part of the IOP per diem when it happens during program hours. Here the crisis call happened in the evening, outside program hours, and the note says so. That separate time and setting is what supports billing H2011 on its own line. If your plan bundles it anyway, expect a CO-97 denial and appeal with the note.

Claim total (midpoint payer): $150.00 + $120.00 = $270.00 in sample charges. Full-unit payer: $150.00 + $90.00 = $240.00.

Common Denials for Behavioral Health H Codes and How to Fix Them

For a full process to cut denials, read how to reduce claim denials, or let our denial management team work the backlog.

Texas Note: H-Codes in Texas Medicaid

Texas Medicaid publishes its behavioral health rules in the Texas Medicaid Provider Procedures Manual (TMPPM), maintained by TMHP. STAR, STAR+PLUS and STAR Kids managed care plans follow it and add their own authorization rules.

• Mental health rehabilitative (MHR) services in Texas use behavioral health H codes. Superior HealthPlan’s Texas clinical policy for these services (TX.CP.BH.544) lists H0034 (medication training and support), H2011 (crisis intervention), H2014 (skills training and development) and H2017 (psychosocial rehabilitation), with HA for child/youth and HQ for group.
• The same policy says a recovery plan that includes H2017 can’t also include H2014, and H2017 can’t be provided while the person is admitted to a crisis stabilization unit.
• Prior authorization: Superior announced a new prior authorization requirement for MHR and mental health targeted case management services, effective March 1, 2026. Other STAR plans set their own rules, so check each plan’s auth list.
• Filing limit: Texas Medicaid claims generally must be filed within 95 days of the date of service.
• Texas substance use disorder codes, unit rules and modifiers for outpatient and residential treatment are in the TMPPM. [VERIFY: Texas SUD H-code list and unit rules in the current TMPPM Behavioral Health handbook]

For Texas rates, see [INTERNAL LINK: Texas Medicaid behavioral health fee schedule]. If you are a Texas provider, our Austin medical billing team works with TMHP and the STAR plans every day, and our Texas credentialing guide covers enrollment before you bill.

FAQs

What are behavioral health H codes?

They are HCPCS Level II codes in the H range (H0001 to H2041) for mental health and substance use services, such as assessments, counseling, crisis intervention, peer support, psychosocial rehab and residential treatment. State Medicaid programs and their managed care plans use them most. Each payer sets its own unit, modifier and authorization rules.

Does Medicare pay for H-codes?

Generally, no. Medicare behavioral health claims use CPT codes such as 90791 and 90834, plus Medicare G-codes. H-codes are mainly used by state Medicaid programs, Medicaid managed care plans and state-funded programs. If you send an H-code to Medicare, expect a denial and rebill with the correct CPT or G-code.

What is the difference between H0004 and 90834?

Both describe individual therapy. H0004 is a HCPCS code billed per 15 minutes, used mainly by Medicaid. 90834 is a CPT psychotherapy code for a session of about 45 minutes, used by Medicare and most commercial plans. The payer decides which one you bill. A 45-minute H0004 session is usually 3 units.

What is H0031 used for?

H0031 is a mental health assessment by a non-physician. Medicaid programs use it for intake and reassessments, often by licensed clinicians and sometimes by other qualified staff. The descriptor names no time unit, so the payer decides whether it is billed per assessment or by time. Medicare and most commercial plans want 90791 instead.

How many units is a 60-minute H2017 session?

H2017 is psychosocial rehabilitation per 15 minutes, so 60 documented minutes equal 4 units under both the midpoint and full-unit methods. The methods only differ when there are leftover minutes. For example, 53 minutes is 4 units under the midpoint method but 3 units under the full-unit method.

Which modifier shows a master’s-level clinician?

HO is the HCPCS modifier for a master’s degree level provider. HN is bachelor’s level, HM is less than bachelor’s level, and HP is doctoral level. Many Medicaid programs require one of these on H-code lines, and some pay a different rate for each level, so check the payer’s code grid.

Do H-codes need prior authorization?

Often, yes. Program-based codes like H0015 (IOP), H0035 (partial hospitalization), residential codes and rehab codes such as H2017 commonly need prior authorization from the Medicaid plan. Requirements differ by state and plan. In Texas, some STAR plans added prior authorization for mental health rehabilitative services in 2026.

Get Behavioral Health H Codes Paid the First Time

Behavioral health H codes pay well for community and program-based care, but only when the code, modifiers, units and authorization all match what the payer expects. Build a code grid for each payer, count units from the note, and check authorizations before the first visit.

DocMBS bills Medicaid H-codes, IOP and PHP programs and substance use services for behavioral health providers. See our behavioral health billing services or book a free billing review.

Sources

• CMS: HCPCS Quarterly Update (Level II code file)
• CMS: Medicare Claims Processing Manual, Chapter 5, Section 20.2 (timed code units)
• X12: Claim Adjustment Reason Codes
• TMHP: Texas Medicaid Provider Procedures Manual
• Superior HealthPlan: Clinical Policy TX.CP.BH.544, Mental Health Rehabilitative Services
• Superior HealthPlan: Effective March 1, 2026: New Clinical Policy for MHR Services and MHTCM

Last updated: October 2026. This article is for education only. Code rules, units and modifiers vary by state and payer. Confirm with your Medicaid program or health plan before submitting claims.