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 Provider Group

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

An Extension used to reference a specific athenahealth provider group 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.

A provider group is an organizational entity representing a set of providers within a practice. It allows a practice to group sets of providers, often in the same specialty and/or location, who share all financial information. Within an athenaEnterprise organization, financial and appointment data as well as patient demographic information are segmented using provider groups.

Every provider group is identified by a single numeric Provider Group ID and is associated to a specific practice in athenahealth. It is represented as a FHIR Organization having an Organization.id defined by a-{PID}.PG-{ID} where {PID} is the Practice ID and {ID} is the Provider Group ID. This resource-level extension is used to specify the appropriate provider group for appropriate 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.

A provider group is an organizational entity representing a set of providers within a practice. It allows a practice to group sets of providers, often in the same specialty and/or location, who share all financial information. Within an athenaEnterprise organization, financial and appointment data as well as patient demographic information are segmented using provider groups.

Provider Group Identity

Every provider group is identified by a single numeric Provider Group ID and is associated to a specific practice in athenahealth. It is represented as a FHIR® Organization having an Organization.id defined by a-{PID}.PG-{ID} where {PID} is the Practice ID and {ID} is the Provider Group ID.

This resource-level extension is used to specify the appropriate provider group for appropriate athenahealth FHIR resources as a literal reference to an Organization. For example:

{
  "id": "...",
  "extension": [
    {
      "url": "https://fhir.athena.io/StructureDefinition/ah-provider-group",
      "valueReference": {
        "reference": "Organization/a-432.PG-4567"
      }
    }
  ],
}

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>provider group</i> Organization.

This structure is derived from Extension

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

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension athenahealth Provider Group
... 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-provider-group"

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>provider group</i> Organization.

Differential View

This structure is derived from Extension

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

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension athenahealth Provider Group
... 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-provider-group"

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()