HL7.FHIR.UV.EXTENSIONS\Patient Proficiency

FHIR Extensions Pack
5.3.0-ballot-tc1 - (September 2025 Ballot) International flag

This page is part of the FHIR Core Extensions Registry (v5.3.0-ballot-tc1: Release 5.3) based on FHIR (HL7® FHIR® Standard) v5.0.0. This version is a pre-release. The current official version is 5.2.0. For a full list of available versions, see the Directory of published versions

Extension: Patient Proficiency

Official URL: http://hl7.org/fhir/StructureDefinition/patient-proficiency			Version: 5.3.0-ballot-tc1
Standards status: Trial-use	Maturity Level: 3	Responsible: HL7 International / Patient Administration	Computable Name: PatProficiency
Other Identifiers: OID:2.16.840.1.113883.4.642.5.1345

Proficiency level of the communication.

Context of Use

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

Element ID: Patient.communication
Element ID: RelatedPerson.communication (FHIR versions R4 and after)
Element ID: Practitioner.communication
Element ID: Person.communication (FHIR versions R5 and after)

Usage info

Usages:

This Extension is not used by any profiles in this Implementation Guide

You can also check for usages in the FHIR IG Statistics

Changes since version 5.2.0:

No changes

Formal Views of Extension Content

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

Text Summary
Differential Table
Snapshot Table
All

This structure is derived from Extension

Summary

Complex Extension: Proficiency level of the communication.

level: Coding: How well the patient can communicate this communication (good, poor, etc.).
type: Coding: What type of communication for the proficiency (spoken, written, etc.).

Maturity: 3

This structure is derived from Extension

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension	0..*	Extension	Proficiency level of the communication
Slices for extension			Content/Rules for all slices
extension:level	0..1	Extension	The proficiency level of the communication
extension	0..0
url	1..1	uri	"level"
value[x]	1..1	Coding	Value of extension Binding: LanguageAbilityProficiency (preferred): The proficiency level for the communication.
extension:type	0..*	Extension	The proficiency type of the communication
extension	0..0
url	1..1	uri	"type"
value[x]	1..1	Coding	Value of extension Binding: LanguageAbilityMode (preferred): The proficiency type for the communication.
url	1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-proficiency"
value[x]	0..0
Documentation for this format

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension	0..*	Extension	Proficiency level of the communication
id	0..1	id	Unique id for inter-element referencing
Slices for extension	0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
extension:level	0..1	Extension	The proficiency level of the communication
id	0..1	id	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"level"
value[x]	1..1	Coding	Value of extension Binding: LanguageAbilityProficiency (preferred): The proficiency level for the communication.
extension:type	0..*	Extension	The proficiency type of the communication
id	0..1	id	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"type"
value[x]	1..1	Coding	Value of extension Binding: LanguageAbilityMode (preferred): The proficiency type for the communication.
url	1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-proficiency"
Documentation for this format

This structure is derived from Extension

Summary

Complex Extension: Proficiency level of the communication.

level: Coding: How well the patient can communicate this communication (good, poor, etc.).
type: Coding: What type of communication for the proficiency (spoken, written, etc.).

Maturity: 3

Differential View

This structure is derived from Extension

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension	0..*	Extension	Proficiency level of the communication
Slices for extension			Content/Rules for all slices
extension:level	0..1	Extension	The proficiency level of the communication
extension	0..0
url	1..1	uri	"level"
value[x]	1..1	Coding	Value of extension Binding: LanguageAbilityProficiency (preferred): The proficiency level for the communication.
extension:type	0..*	Extension	The proficiency type of the communication
extension	0..0
url	1..1	uri	"type"
value[x]	1..1	Coding	Value of extension Binding: LanguageAbilityMode (preferred): The proficiency type for the communication.
url	1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-proficiency"
value[x]	0..0
Documentation for this format

Snapshot View

Name	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Extension	0..*	Extension	Proficiency level of the communication
id	0..1	id	Unique id for inter-element referencing
Slices for extension	0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
extension:level	0..1	Extension	The proficiency level of the communication
id	0..1	id	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"level"
value[x]	1..1	Coding	Value of extension Binding: LanguageAbilityProficiency (preferred): The proficiency level for the communication.
extension:type	0..*	Extension	The proficiency type of the communication
id	0..1	id	Unique id for inter-element referencing
extension	0..0
url	1..1	uri	"type"
value[x]	1..1	Coding	Value of extension Binding: LanguageAbilityMode (preferred): The proficiency type for the communication.
url	1..1	uri	"http://hl7.org/fhir/StructureDefinition/patient-proficiency"
Documentation for this format

Other representations of profile: CSV, Excel, Schematron

Terminology Bindings

Path	Conformance	ValueSet	URI
Extension.extension:level.value[x]	preferred	LanguageAbilityProficiency `http://terminology.hl7.org/ValueSet/v3-LanguageAbilityProficiency`
Extension.extension:type.value[x]	preferred	LanguageAbilityMode `http://terminology.hl7.org/ValueSet/v3-LanguageAbilityMode`

Constraints

Id	Grade	Path(s)	Details	Requirements
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()

R4B

The extension is unchanged in R4B

R4

The extension is unchanged in R4

R3

The extension is unchanged in R3

Search Parameters for this Extension

(none found)

IG © 2022+ HL7 International / FHIR Infrastructure. Package hl7.fhir.uv.extensions#5.3.0-ballot-tc1 based on FHIR 5.0.0. Generated 2025-08-03
Links: Table of Contents | QA Report | Version History | | Propose a change