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

# Appendix A - Code Tables Overview

> Index of all valid code values used in the CoBHRM data model

## Overview

Appendix A contains all valid code values used throughout CoBHRM. When submitting data, you must use the exact codes specified in these tables.

> [!WARNING]
>
> Using invalid codes will result in validation errors. Always refer to the current version of Appendix A for valid values.

## Code Table Index

> **[Service Identifiers](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/service-identifiers.md)**
>
> 24 service type and treatment modality codes (SUD, MH, WM)

> **[Counties](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/counties.md)**
>
> Two-digit Colorado county codes for client residence

> **[Referral Sources](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/referral-sources.md)**
>
> Referral source classification codes including Colorado-specific programs

> **[Legal Status](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/legal-status/index.md)**
>
> Legal status codes for admissions and discharges

> **[Gender Codes](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/gender-codes/index.md)**
>
> Sex at birth, gender identity, and sexual orientation codes

> **[Race & Ethnicity](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/race-ethnicity/index.md)**
>
> Race (multi-select) and ethnicity classification codes

> **[Household Language](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/demographics/household-language.md)**
>
> 21 language codes plus unknown/declined

> **[Marital Status](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/demographics/marital-status.md)**
>
> Marital status codes

> **[Living Situation](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/living-situation.md)**
>
> Housing and living arrangement codes

> **[Employment Status](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/employment-status.md)**
>
> Employment status codes

> **[Social](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/social/index.md)**
>
> Education, income, and other social determinant codes

> **[Clinical](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/clinical/index.md)**
>
> SMI/SED status, involuntary reason, and clinical indicator codes

> **[Disabilities](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/disabilities.md)**
>
> 16 disability codes (multi-select)

> **[Substance Types](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/substance-types/index.md)**
>
> 29 substance codes, routes of administration, and ASAM levels

> **[ACT & Ascent](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/act-ascent/index.md)**
>
> MCSI, QoL, Social/Role Functioning, Stage of Change, and related codes

> **[Special Connections](https://coloradobehavioralhealthadministration.mintlify.site/reference/appendix-a/special-connections/index.md)**
>
> Pregnancy risk screening and baby outcome value sets

## Code Table Format

Each code table includes:

| Column | Description |
| - | - |
| **Code** | The exact value to use in your data file |
| **Description** | Human-readable meaning of the code |

## Standard Unknown / Declined Codes

Several standard codes recur across many value sets. When a value set supports them, use:

| Code | Meaning |
| - | - |
| `95` | Not Applicable |
| `96` | Asked but Unknown |
| `97` | Other |
| `98` | Declined |
| `99` | Unknown |

> [!WARNING]
>
> Not every value set includes all five codes. Check the specific reference table for which of these codes are valid. Using a code not listed in the value set will fail validation.

## Using Code Tables

### Single-Value Fields

For fields that accept a single code value, use the code exactly as shown:

```csv theme={null}
SEX_AT_BIRTH|COUNTY_OF_RESIDENCE|REFERRAL_SOURCE
01|17|01
```

### Multi-Value Fields

Some fields accept multiple values separated by semicolon and space (`; `):

```csv theme={null}
RACE|DISABILITY_CODES
01; 05|02; 08
```

> [!TIP]
>
> The delimiter for multi-value fields is semicolon followed by a single space: `; `

## How Coded Values Work

* Each coded field in a record spec references an appendix code table.
* The value stored in the CSV file is the **numeric code** (e.g., `01`), not the description text.
* Codes are **case-sensitive** and must match exactly.
* Leading zeros matter -- `01` is not the same as `1` in string-typed fields.

> [!NOTE]
>
> Code values may be added or retired over time. Always check the current version of Appendix A when working with data.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.