Athena Core Implementation Guide
5.10.2 - release

Athena Core Implementation Guide - Local Development build (v5.10.2) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Extension: athenahealth Practice

Official URL: https://fhir.athena.io/StructureDefinition/ah-practice Version: 5.10.2
Active as of 2026-05-26 Computable Name: AthenaPractice

An Extension used to reference a specific athenahealth practice Organization.

athenahealth provides a multi-tenant SaaS platform on which our customers provide healthcare services to their patients. Tenants are defined as practices within athenahealth. In general, a practice can be a hospital, medical center, clinic, or any other healthcare-related entity. Typically, a practice represents the business entity that provides healthcare services and can be in a single location or spread across multiple locations.

Every practice is identified by a single numeric Practice ID within athenahealth. It is represented as a FHIR Organization having an Organization.id defined by a-1.Practice-{PID} where {PID} is the Practice ID. This resource-level extension is used to specify the appropriate practice (tenant) for all athenahealth FHIR resources as a literal reference to a FHIR Organization.

Context of Use

This extension may be used on the following element(s):

  • Element ID Resource

Background

athenahealth provides a multi-tenant SaaS platform on which our customers provide healthcare services to their patients. Tenants are defined as practices within athenahealth. In general, a practice can be a hospital, medical center, clinic, or any other healthcare-related entity. Typically, a practice represents the business entity that provides healthcare services and can be in a single location or spread across multiple locations.

Practice Identity

Every practice is identified by a single numeric Practice ID within athenahealth. It is represented as a FHIR® Organization having an Organization.id defined by a-1.Practice-{PID} where {PID} is the Practice ID.

This resource-level extension is used to specify the appropriate practice (tenant) for all athenahealth FHIR resources as a literal reference to an Organization. For example:

{
  "id": "...",
  "extension": [
    {
      "url": "https://fhir.athena.io/StructureDefinition/ah-practice",
      "valueReference": {
        "reference": "Organization/a-1.Practice-432"
      }
    }
  ],
}

Usage info

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

This structure is derived from Extension

Summary

Simple Extension with the type Reference: An Extension used to reference a specific <b>athenahealth</b> <i>practice</i> Organization.

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension athenahealth Practice
... extension 0..0 Extension
... url 1..1 uri "https://fhir.athena.io/StructureDefinition/ah-practice"
... value[x] 1..1 Reference(Organization) Reference to athenahealth Organization for 'practice'

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension athenahealth Practice
... id 0..1 string Unique id for inter-element referencing
... extension 0..0 Extension
Slice: Unordered, Open by value:url
... url 1..1 uri "https://fhir.athena.io/StructureDefinition/ah-practice"

doco Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type Reference: An Extension used to reference a specific <b>athenahealth</b> <i>practice</i> Organization.

Differential View

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension athenahealth Practice
... extension 0..0 Extension
... url 1..1 uri "https://fhir.athena.io/StructureDefinition/ah-practice"
... value[x] 1..1 Reference(Organization) Reference to athenahealth Organization for 'practice'

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension athenahealth Practice
... id 0..1 string Unique id for inter-element referencing
... extension 0..0 Extension
Slice: Unordered, Open by value:url
... url 1..1 uri "https://fhir.athena.io/StructureDefinition/ah-practice"

doco Documentation for this format

 

​Other representations of profile: CSV, Excel, Schematron

Constraints

Id Grade Path(s) Description Expression
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()