SGHI FHIR Profile Implementation Guide
0.1.0 - ci-build

SGHI FHIR Profile Implementation Guide, published by Kathurima Kimathi. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/savannahghi/sil_fhir_profile_ig/ and changes regularly. See the Directory of published versions

## Resource Profile: SGHI Organization

Official URL: https://fhir.slade360.co.ke/fhir/StructureDefinition/organization | Version: 0.1.0
Draft as of 2026-04-27 | Computable Name: SGHIOrganization

SGHI's profile for Organization

Usages:

- Refer to this Profile: SGHI Activity Defintion Profile, SGHI AllergyIntolerance, SGHI Appointment Profile, SGHI Care Plan... Show 24 more, SGHI Composition, SGHI Condition, SGHI Consent, SGHI DiagnosticReport, SGHI DocumentReference Profile., SGHI Encounter, SGHI EpisodeOfCare, SGHI Location, SGHI Medication, SGHI Medication Dispense, SGHI MedicationRequest, SGHI Observation, SGHI Organization, SGHI Patient, SGHI Plan Definition Profile, SGHI Practitioner, SGHI PractitionerRole, SGHI Procedure, SGHI QuestionnaireResponse, SGHI RiskAssessment, SGHI ServiceRequest, SGHI Specimen, SGHI Substance and SGHI Task
- Examples for this Profile: SGHI Healthcare Organization

You can also check for usages in the FHIR IG Statistics

### Formal Views of Profile Content

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

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Organization | C | 0..* | Organization | A grouping of people or organizations with a common purpose Constraints: org-1
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
contained |  | 0..* | Resource | Contained, inline Resources
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ C | 1..* | Identifier | Identifies this organization across multiple systems
use | ?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required)
type | Σ | 0..1 | SGHICodeableConcept | Description of identifier Binding: SGHI Organization Identifier Types (required)
system | Σ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value | Σ C | 1..1 | string | The value that is unique Example General: 123456
active | ?!Σ | 1..1 | boolean | Whether the organization's record is still in active use
name | Σ C | 1..1 | string | Name used for the organization
partOf | Σ | 0..1 | SGHIReference(SGHI Organization) | The organization of which this organization forms a part
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Organization.identifier.​use | Base | required | IdentifierUse | 📦5.0.0 | FHIR Std.
Organization.identifier.​type | Base | required | SGHI Organization Identifier Types | 📦0.1.0 | This IG

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | Organization | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | Organization | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | Organization | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | Organization | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Organization | A resource should have narrative for robust management | `text.`div`.exists()`
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()`
org-1 | error | Organization | The organization SHALL at least have a name or an identifier, and possibly more than one | `(identifier.count() + name.count()) > 0`

This structure is derived from Organization

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Organization |  | 0..* | Organization | A grouping of people or organizations with a common purpose
identifier |  | 1..* | Identifier | Identifies this organization across multiple systems
use |  | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required)
type |  | 0..1 | SGHICodeableConcept | Description of identifier Binding: SGHI Organization Identifier Types (required)
system |  | 1..1 | uri | The namespace for the identifier value
value |  | 1..1 | string | The value that is unique
active |  | 1..1 | boolean | Whether the organization's record is still in active use
name |  | 1..1 | string | Name used for the organization
partOf |  | 0..1 | SGHIReference(SGHI Organization) | The organization of which this organization forms a part
qualification |  |  |  |
issuer |  | 0..1 | SGHIReference(SGHI Organization) | Organization that regulates and issues the qualification
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Organization.identifier.​use | Base | required | IdentifierUse | 📦5.0.0 | FHIR Std.
Organization.identifier.​type | Base | required | SGHI Organization Identifier Types | 📦0.1.0 | This IG

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Organization | C | 0..* | Organization | A grouping of people or organizations with a common purpose Constraints: org-1
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: AllLanguages (required): IETF language tag for a human language
Additional Bindings | Purpose
CommonLanguages | Starter
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ C | 1..* | Identifier | Identifies this organization across multiple systems
id |  | 0..1 | id | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
use | ?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required)
type | Σ | 0..1 | SGHICodeableConcept | Description of identifier Binding: SGHI Organization Identifier Types (required)
system | Σ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value | Σ C | 1..1 | string | The value that is unique Example General: 123456
period | Σ | 0..1 | Period | Time period when id is/was valid for use
assigner | Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
active | ?!Σ | 1..1 | boolean | Whether the organization's record is still in active use
type | Σ | 0..* | CodeableConcept | Kind of organization Binding: OrganizationType (example): Used to categorize the organization.
name | Σ C | 1..1 | string | Name used for the organization
alias |  | 0..* | string | A list of alternate names that the organization is known as, or was known as in the past
description | Σ | 0..1 | markdown | Additional details about the Organization that could be displayed as further information to identify the Organization beyond its name
contact | C | 0..* | ExtendedContactDetail | Official contact details for the Organization Constraints: org-3, org-4
partOf | Σ | 0..1 | SGHIReference(SGHI Organization) | The organization of which this organization forms a part
endpoint |  | 0..* | Reference(Endpoint) | Technical endpoints providing access to services operated for the organization
qualification |  | 0..* | BackboneElement | Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
identifier |  | 0..* | Identifier | An identifier for this qualification for the organization
code |  | 1..1 | CodeableConcept | Coded representation of the qualification Binding Description: (example): Specific qualification the organization has to provide a service.
period |  | 0..1 | Period | Period during which the qualification is valid
issuer |  | 0..1 | SGHIReference(SGHI Organization) | Organization that regulates and issues the qualification
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Organization.language | Base | required | All Languages | 📍5.0.0 | FHIR Std.
Organization.identifier.​use | Base | required | IdentifierUse | 📦5.0.0 | FHIR Std.
Organization.identifier.​type | Base | required | SGHI Organization Identifier Types | 📦0.1.0 | This IG
Organization.type | Base | example | Organization Type | 📍5.0.0 | FHIR Std.
Organization.qualification.​code | Base | example |  | Not State | Unknown

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | Organization | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | Organization | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | Organization | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | Organization | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Organization | A resource should have narrative for robust management | `text.`div`.exists()`
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()`
org-1 | error | Organization | The organization SHALL at least have a name or an identifier, and possibly more than one | `(identifier.count() + name.count()) > 0`
org-3 | error | Organization.contact | The telecom of an organization can never be of use 'home' | `telecom.where(use = 'home').empty()`
org-4 | error | Organization.contact | The address of an organization can never be of use 'home' | `address.where(use = 'home').empty()`

This structure is derived from Organization

Summary

Mandatory: 5 elements

Structures

This structure refers to these other structures:

- SGHI CodeableConcept (https://fhir.slade360.co.ke/fhir/StructureDefinition/codeableconcept)
- SGHI Reference (https://fhir.slade360.co.ke/fhir/StructureDefinition/reference)
- SGHI Organization (https://fhir.slade360.co.ke/fhir/StructureDefinition/organization)

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Organization | C | 0..* | Organization | A grouping of people or organizations with a common purpose Constraints: org-1
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
contained |  | 0..* | Resource | Contained, inline Resources
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ C | 1..* | Identifier | Identifies this organization across multiple systems
use | ?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required)
type | Σ | 0..1 | SGHICodeableConcept | Description of identifier Binding: SGHI Organization Identifier Types (required)
system | Σ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value | Σ C | 1..1 | string | The value that is unique Example General: 123456
active | ?!Σ | 1..1 | boolean | Whether the organization's record is still in active use
name | Σ C | 1..1 | string | Name used for the organization
partOf | Σ | 0..1 | SGHIReference(SGHI Organization) | The organization of which this organization forms a part
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Organization.identifier.​use | Base | required | IdentifierUse | 📦5.0.0 | FHIR Std.
Organization.identifier.​type | Base | required | SGHI Organization Identifier Types | 📦0.1.0 | This IG

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | Organization | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | Organization | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | Organization | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | Organization | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Organization | A resource should have narrative for robust management | `text.`div`.exists()`
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()`
org-1 | error | Organization | The organization SHALL at least have a name or an identifier, and possibly more than one | `(identifier.count() + name.count()) > 0`

Differential View

This structure is derived from Organization

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Organization |  | 0..* | Organization | A grouping of people or organizations with a common purpose
identifier |  | 1..* | Identifier | Identifies this organization across multiple systems
use |  | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required)
type |  | 0..1 | SGHICodeableConcept | Description of identifier Binding: SGHI Organization Identifier Types (required)
system |  | 1..1 | uri | The namespace for the identifier value
value |  | 1..1 | string | The value that is unique
active |  | 1..1 | boolean | Whether the organization's record is still in active use
name |  | 1..1 | string | Name used for the organization
partOf |  | 0..1 | SGHIReference(SGHI Organization) | The organization of which this organization forms a part
qualification |  |  |  |
issuer |  | 0..1 | SGHIReference(SGHI Organization) | Organization that regulates and issues the qualification
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Organization.identifier.​use | Base | required | IdentifierUse | 📦5.0.0 | FHIR Std.
Organization.identifier.​type | Base | required | SGHI Organization Identifier Types | 📦0.1.0 | This IG

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Organization | C | 0..* | Organization | A grouping of people or organizations with a common purpose Constraints: org-1
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: AllLanguages (required): IETF language tag for a human language
Additional Bindings | Purpose
CommonLanguages | Starter
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ C | 1..* | Identifier | Identifies this organization across multiple systems
id |  | 0..1 | id | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
use | ?!Σ | 0..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required)
type | Σ | 0..1 | SGHICodeableConcept | Description of identifier Binding: SGHI Organization Identifier Types (required)
system | Σ | 1..1 | uri | The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value | Σ C | 1..1 | string | The value that is unique Example General: 123456
period | Σ | 0..1 | Period | Time period when id is/was valid for use
assigner | Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
active | ?!Σ | 1..1 | boolean | Whether the organization's record is still in active use
type | Σ | 0..* | CodeableConcept | Kind of organization Binding: OrganizationType (example): Used to categorize the organization.
name | Σ C | 1..1 | string | Name used for the organization
alias |  | 0..* | string | A list of alternate names that the organization is known as, or was known as in the past
description | Σ | 0..1 | markdown | Additional details about the Organization that could be displayed as further information to identify the Organization beyond its name
contact | C | 0..* | ExtendedContactDetail | Official contact details for the Organization Constraints: org-3, org-4
partOf | Σ | 0..1 | SGHIReference(SGHI Organization) | The organization of which this organization forms a part
endpoint |  | 0..* | Reference(Endpoint) | Technical endpoints providing access to services operated for the organization
qualification |  | 0..* | BackboneElement | Qualifications, certifications, accreditations, licenses, training, etc. pertaining to the provision of care
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
identifier |  | 0..* | Identifier | An identifier for this qualification for the organization
code |  | 1..1 | CodeableConcept | Coded representation of the qualification Binding Description: (example): Specific qualification the organization has to provide a service.
period |  | 0..1 | Period | Period during which the qualification is valid
issuer |  | 0..1 | SGHIReference(SGHI Organization) | Organization that regulates and issues the qualification
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Organization.language | Base | required | All Languages | 📍5.0.0 | FHIR Std.
Organization.identifier.​use | Base | required | IdentifierUse | 📦5.0.0 | FHIR Std.
Organization.identifier.​type | Base | required | SGHI Organization Identifier Types | 📦0.1.0 | This IG
Organization.type | Base | example | Organization Type | 📍5.0.0 | FHIR Std.
Organization.qualification.​code | Base | example |  | Not State | Unknown

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | Organization | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | Organization | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | Organization | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | Organization | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Organization | A resource should have narrative for robust management | `text.`div`.exists()`
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()`
org-1 | error | Organization | The organization SHALL at least have a name or an identifier, and possibly more than one | `(identifier.count() + name.count()) > 0`
org-3 | error | Organization.contact | The telecom of an organization can never be of use 'home' | `telecom.where(use = 'home').empty()`
org-4 | error | Organization.contact | The address of an organization can never be of use 'home' | `address.where(use = 'home').empty()`

This structure is derived from Organization

Summary

Mandatory: 5 elements

Structures

This structure refers to these other structures:

- SGHI CodeableConcept (https://fhir.slade360.co.ke/fhir/StructureDefinition/codeableconcept)
- SGHI Reference (https://fhir.slade360.co.ke/fhir/StructureDefinition/reference)
- SGHI Organization (https://fhir.slade360.co.ke/fhir/StructureDefinition/organization)

Other representations of profile: CSV, Excel, Schematron