> ## Documentation Index
> Fetch the complete documentation index at: https://docs.medera.info/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome to Medera Medical Coding

> ICD-10, CPT, HCPCS, SNOMED CT, LOINC, RxNorm calibrated for behavioral health.

Medera Medical Coding generates accurate, defensible codes from clinical context — every code anchored to a quoted note span and reported with calibrated confidence. The engine is **behavioral-health-aware** — F-code specificity, BH-relevant CPT and E\&M, psychotropic RxNorm — but supports the full coding surface for primary care overlap.

<Tip>
  Every code returned by the Medera API includes the documentation span that supports it. Suggestions never auto-post — the coder or clinician confirms.
</Tip>

## Supported code systems

<CardGroup cols={4}>
  <Card title="ICD-10-CM" href="/coding/icd-10-cm" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/hashtag.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=aad176642277709c5c2964dfa5bea30d" horizontal width="40" height="40" data-path="icons/ui/hashtag.svg">US diagnosis</Card>
  <Card title="ICD-10-PCS" href="/coding/icd-10-pcs" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/hashtag.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=aad176642277709c5c2964dfa5bea30d" horizontal width="40" height="40" data-path="icons/ui/hashtag.svg">US inpatient procedure</Card>
  <Card title="ICD-10" href="/coding/icd-10-int" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/hashtag.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=aad176642277709c5c2964dfa5bea30d" horizontal width="40" height="40" data-path="icons/ui/hashtag.svg">WHO international</Card>
  <Card title="CPT" href="/coding/cpt" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/hashtag.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=aad176642277709c5c2964dfa5bea30d" horizontal width="40" height="40" data-path="icons/ui/hashtag.svg">Outpatient procedure / E\&M</Card>
  <Card title="HCPCS Level II" href="/coding/hcpcs" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/hashtag.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=aad176642277709c5c2964dfa5bea30d" horizontal width="40" height="40" data-path="icons/ui/hashtag.svg">Non-physician services</Card>
  <Card title="SNOMED CT" href="/coding/snomed-ct" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/hashtag.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=aad176642277709c5c2964dfa5bea30d" horizontal width="40" height="40" data-path="icons/ui/hashtag.svg">Clinical terminology</Card>
  <Card title="LOINC" href="/coding/loinc" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/hashtag.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=aad176642277709c5c2964dfa5bea30d" horizontal width="40" height="40" data-path="icons/ui/hashtag.svg">Lab + instrument observations</Card>
  <Card title="RxNorm" href="/coding/rxnorm" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/hashtag.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=aad176642277709c5c2964dfa5bea30d" horizontal width="40" height="40" data-path="icons/ui/hashtag.svg">Psychotropic + general medication</Card>
</CardGroup>

## Endpoints

| Endpoint                                        | Surface     | Purpose                                                     |
| :---------------------------------------------- | :---------- | :---------------------------------------------------------- |
| `POST /api/therapy/suggest-codes`               | AI Services | Standalone suggestion from diagnosis + procedure text       |
| `POST /api/pa/coding-suggest`                   | AI Services | Real-time detection during intake — flags PA-required codes |
| `POST /api/therapy/generate-soap-note-enhanced` | AI Services | SOAP with `include_billing_codes: true`                     |

## Use cases

<CardGroup cols={3}>
  <Card title="Encounter coding" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/clipboard-check.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=9cf869d685b45a2ec31be2b3d675a841" href="/coding/encounter-coding" width="40" height="40" data-path="icons/ui/clipboard-check.svg">
    Assign accurate diagnosis and procedure codes to behavioral-health encounters using documentation-anchored suggestions.
  </Card>

  <Card title="Clinical Documentation Improvement" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/file-pen.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=7a092163a19603cf99af65ed0de4639b" href="/coding/cdi" width="40" height="40" data-path="icons/ui/file-pen.svg">
    Surface missing specificity, severity qualifiers, and gaps as clinical queries before sign-off.
  </Card>

  <Card title="Revenue cycle" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/chart-line.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=c4831c9d7d3dd913eed06ca94e3b99bd" href="/coding/revenue-cycle" width="40" height="40" data-path="icons/ui/chart-line.svg">
    Sweep panels for missed codes, run retrospective audits, resubmit cleanly.
  </Card>
</CardGroup>

## Response shape

```json theme={"system"}
{
  "system": "icd-10-cm",
  "code": "F32.1",
  "display": "Major depressive disorder, single episode, moderate",
  "confidence": 0.92,
  "anchor": {
    "documentId": "doc_abc",
    "span": { "start": 412, "end": 489 },
    "quote": "Patient reports persistent low mood for 6 weeks..."
  },
  "severity_qualifier_suggestions": ["severe"],
  "documentation_gap": null,
  "pa_required": false,
  "payer_policy_url": null
}
```

## Common BH codes

### ICD-10-CM (F-code subset)

| Code              | Description                                                |
| :---------------- | :--------------------------------------------------------- |
| `F32.0` – `F32.9` | Major depressive disorder, single episode (severity range) |
| `F33.0` – `F33.9` | Major depressive disorder, recurrent (severity range)      |
| `F40.x`           | Phobic anxiety disorders                                   |
| `F41.0`           | Panic disorder                                             |
| `F41.1`           | Generalized anxiety disorder                               |
| `F43.10`          | PTSD, unspecified                                          |
| `F43.11`          | PTSD, acute                                                |
| `F43.12`          | PTSD, chronic                                              |
| `F11.20`          | Opioid use disorder, moderate / severe                     |
| `F10.20`          | Alcohol use disorder, moderate / severe                    |
| `F90.x`           | ADHD subtypes                                              |
| `F84.0`           | Autism spectrum disorder                                   |
| `F31.x`           | Bipolar disorder (specifiers)                              |
| `F20.x`           | Schizophrenia spectrum                                     |
| `F50.x`           | Eating disorders                                           |

### CPT — behavioral health subset

| Code              | Description                                             |
| :---------------- | :------------------------------------------------------ |
| `90791`           | Psychiatric diagnostic evaluation                       |
| `90792`           | Psychiatric diagnostic evaluation with medical services |
| `90832`           | Psychotherapy, 30 min                                   |
| `90834`           | Psychotherapy, 45 min                                   |
| `90837`           | Psychotherapy, 60 min                                   |
| `90839`, `90840`  | Crisis psychotherapy (60 min + add-on)                  |
| `90846`, `90847`  | Family psychotherapy (without / with patient)           |
| `90853`           | Group psychotherapy                                     |
| `96127`           | Brief emotional / behavioral assessment                 |
| `96130`, `96131`  | Psychological testing evaluation services               |
| `99213` – `99215` | Established patient E/M                                 |
| `99491` – `99494` | Collaborative care management (CoCM)                    |
| `G2214`           | Behavioral health integration                           |

### HCPCS Level II

| Code              | Description                                               |
| :---------------- | :-------------------------------------------------------- |
| `H0001` – `H0050` | BH-specific services (assessment, IOP, PHP, peer support) |
| `H2011`           | Crisis intervention service                               |
| `S9480`           | IOP, mental health                                        |
| `S0201`           | Partial hospitalization, mental health                    |

### SNOMED CT (BH concepts)

| Concept ID  | Description                    |
| :---------- | :----------------------------- |
| `35489007`  | Depressive disorder            |
| `48694002`  | Anxiety                        |
| `47505003`  | Post-traumatic stress disorder |
| `6471006`   | Suicidal ideation              |
| `193462001` | Insomnia                       |
| `13746004`  | Bipolar disorder               |
| `58214004`  | Schizophrenia                  |

### RxNorm — psychotropics

| RxCUI    | Description  |
| :------- | :----------- |
| `36437`  | Sertraline   |
| `321988` | Escitalopram |
| `4493`   | Fluoxetine   |
| `32937`  | Paroxetine   |
| `39786`  | Venlafaxine  |
| `72625`  | Duloxetine   |
| `10737`  | Trazodone    |
| `39993`  | Zolpidem     |
| `1827`   | Buspirone    |
| `25480`  | Gabapentin   |
| `187832` | Pregabalin   |
| `6850`   | Lithium      |
| `28439`  | Lamotrigine  |
| `42347`  | Quetiapine   |

***

## What's next

<CardGroup cols={2}>
  <Card title="Quickstart" icon="https://mintcdn.com/medera-357fd587/n1mgcc3nR2sq_PoL/icons/ui/zap.svg?fit=max&auto=format&n=n1mgcc3nR2sq_PoL&q=85&s=279c57d41af922abbba25c4afddfc3fe" href="/coding/quickstart" width="40" height="40" data-path="icons/ui/zap.svg">Suggest codes for your first note.</Card>
  <Card title="Core Concepts" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/book.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=491b19a75d428ef8cd36d8afc2d3612c" href="/coding/introduction" width="40" height="40" data-path="icons/ui/book.svg">Understand every field in the response.</Card>
  <Card title="How it works" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/settings.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=d4e5b78d0364e67249682468c3175436" href="/coding/how-it-works" width="40" height="40" data-path="icons/ui/settings.svg">Request structure + best practices.</Card>
  <Card title="Coding Systems" icon="https://mintcdn.com/medera-357fd587/iC-6rAuwl-0aQSw_/icons/ui/layers.svg?fit=max&auto=format&n=iC-6rAuwl-0aQSw_&q=85&s=b19e6f39887a8a61762fcb53957d2271" href="/coding/coding-systems" width="40" height="40" data-path="icons/ui/layers.svg">Feature availability per system.</Card>
</CardGroup>
