# Colorado BHA Client Profile - Colorado BHA FHIR Implementation Guide v0.1.0

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Colorado BHA Client Profile**

## Resource Profile: Colorado BHA Client Profile 

| | |
| :--- | :--- |
| *Official URL*:http://bha.colorado.gov/fhir/bha-test-ig/StructureDefinition/bha-client | *Version*:0.1.0 |
| Draft as of 2026-03-06 | *Computable Name*:BHAClient |

 
Ths profile specifies the mandatory and must support data elements for capturing demographic information for Colorado BHA clients in order to support the BHA's annual reporting requirements. 

**Usages:**

* Examples for this Profile: [Patient/BHAClientExample](Patient-BHAClientExample.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/bha-test-ig|current/StructureDefinition/bha-client)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-bha-client.csv), [Excel](StructureDefinition-bha-client.xlsx), [Schematron](StructureDefinition-bha-client.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "bha-client",
  "url" : "http://bha.colorado.gov/fhir/bha-test-ig/StructureDefinition/bha-client",
  "version" : "0.1.0",
  "name" : "BHAClient",
  "title" : "Colorado BHA Client Profile",
  "status" : "draft",
  "date" : "2026-03-06T19:31:49+00:00",
  "publisher" : "Colorado Behavioral Health Administration",
  "contact" : [{
    "name" : "Colorado Behavioral Health Administration",
    "telecom" : [{
      "system" : "url",
      "value" : "https://bha.colorado.gov"
    },
    {
      "system" : "email",
      "value" : "cdhs_bha_provider_support@state.co.us"
    }]
  }],
  "description" : "Ths profile specifies the mandatory and must support data elements for capturing demographic information \nfor Colorado BHA clients in order to support the BHA's annual reporting requirements.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "840"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "cda",
    "uri" : "http://hl7.org/v3/cda",
    "name" : "CDA (R2)"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  },
  {
    "identity" : "loinc",
    "uri" : "http://loinc.org",
    "name" : "LOINC code for the element"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Patient",
  "baseDefinition" : "http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient|6.1.0",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Patient",
      "path" : "Patient"
    },
    {
      "id" : "Patient.extension",
      "path" : "Patient.extension",
      "min" : 1
    },
    {
      "id" : "Patient.extension:bharace",
      "path" : "Patient.extension",
      "sliceName" : "bharace",
      "short" : "BHA race code",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://bha.colorado.gov/fhir/bha-test-ig/StructureDefinition/bha-race"]
      }]
    },
    {
      "id" : "Patient.extension:USVeteranStatus",
      "path" : "Patient.extension",
      "sliceName" : "USVeteranStatus",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://hl7.org/fhir/us/military-service/StructureDefinition/military-service-veteran-status"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Patient.identifier",
      "path" : "Patient.identifier",
      "slicing" : {
        "discriminator" : [{
          "type" : "pattern",
          "path" : "type"
        }],
        "rules" : "open"
      }
    },
    {
      "id" : "Patient.identifier:SSN",
      "path" : "Patient.identifier",
      "sliceName" : "SSN",
      "short" : "The client's Social Security number",
      "min" : 0,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Patient.identifier:SSN.type",
      "path" : "Patient.identifier.type",
      "min" : 1,
      "patternCodeableConcept" : {
        "coding" : [{
          "system" : "http://terminology.hl7.org/CodeSystem/v2-0203",
          "code" : "SS"
        }]
      }
    },
    {
      "id" : "Patient.identifier:SSN.system",
      "path" : "Patient.identifier.system",
      "patternUri" : "http://hl7.org/fhir/sid/us-ssn"
    },
    {
      "id" : "Patient.name",
      "path" : "Patient.name",
      "short" : "A name associated with the Client."
    },
    {
      "id" : "Patient.birthDate",
      "path" : "Patient.birthDate",
      "min" : 1
    },
    {
      "id" : "Patient.address.district",
      "path" : "Patient.address.district",
      "min" : 1,
      "mustSupport" : true,
      "binding" : {
        "strength" : "required",
        "valueSet" : "http://bha.colorado.gov/fhir/bha-test-ig/ValueSet/bha-counties-vs"
      }
    },
    {
      "id" : "Patient.address.postalCode",
      "path" : "Patient.address.postalCode",
      "min" : 1
    },
    {
      "id" : "Patient.maritalStatus",
      "path" : "Patient.maritalStatus",
      "min" : 1,
      "mustSupport" : true
    }]
  }
}

```
