Uzbekistan Core socioeconomic observation profile, used to represent patients' benefits, education, profession, and social status.

UZ Core Socioeconomic Observation captures a patient's preferential/benefit category and socioeconomic status - the facts that influence reimbursement eligibility, such as a disability or social-benefit group, as well as education, profession, and social status. It is modelled as an Observation so it lives alongside clinical observations but is categorised distinctly. Use the Observation endpoint to read and search these records.

Mandatory and Must Support data elements

The elements below must always be present (mandatory) or must be supported when the data is available (Must Support) - not all are required, but your system must populate each Must Support element when it has the data and process it on receipt. This is the human-readable summary; the formal views below give the exact cardinalities, types, and terminology bindings.

Each UZ Core Socioeconomic Observation Must Have

Every Socioeconomic Observation must carry a subject - the Patient the record is about (1..1), a code carrying the socioeconomic observation type through the required socioeconomicType coding slice (1..1) - one of Eligible for benefit, Educational achievement, Occupation, or Social status (SNOMED CT, bound to the DHP socioeconomic-observation-codes value set) - an effectiveDateTime (when the data was recorded or applies, 1..1), and a status inherited from the base resource.

Each UZ Core Socioeconomic Observation Must Support

• the subject, the code (with its socioeconomicType slice), and the effectiveDateTime listed above.

The value[x] is a CodeableConcept whose value set depends on the code: benefits use BenefitsVS, education uses EducationVS, profession uses PositionAndProfessionVS, and social status uses SocialStatusVS. Pick the value set that matches the chosen type code.

Building the JSON, step by step

The examples below go from the smallest instance the server will accept to a fully populated socioeconomic record. Copy one and adapt it - every value shown validates against this profile. The full reference instances are linked at the bottom of the page (for example education, social status, profession, benefits).

The smallest socioeconomic observation you should send

Four elements carry the whole record: the status and the subject (the Patient it is about), the code saying which kind of socioeconomic fact this is (through the required socioeconomicType coding slice, always a SNOMED CT code from http://snomed.info/sct), and the effectiveDateTime when it was recorded. The result itself goes in valueCodeableConcept. This education-level record already passes validation:

{
  "resourceType": "Observation",
  "language": "uz",
  "meta": {
    "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-socioeconomic-observation" ]
  },
  "status": "final",
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "105421008",
        "display": "Educational achievement"
      }
    ]
  },
  "subject": { "reference": "Patient/example-salim" },
  "valueCodeableConcept": {
    "coding": [
      {
        "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/education-cs",
        "code": "regis0005.00004",
        "display": "O'rtacha"
      }
    ]
  },
  "effectiveDateTime": "2025-06-11"
}

The code is what selects the kind of fact; here 105421008 (Educational achievement) means the valueCodeableConcept is drawn from EducationVS. The subject is a plain Reference, so the target sits directly under reference ("subject": { "reference": "Patient/example-salim" }).

A social-status record

Swap the type code and the result value set together - they always move as a pair. For a patient's social status, the code is 82996008 (Social status) and the valueCodeableConcept is drawn from SocialStatusVS:

{
  "resourceType": "Observation",
  "language": "uz",
  "meta": {
    "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-socioeconomic-observation" ]
  },
  "status": "final",
  "code": {
    "coding": [
      { "system": "http://snomed.info/sct", "code": "82996008", "display": "Social status" }
    ]
  },
  "subject": { "reference": "Patient/example-salim" },
  "valueCodeableConcept": {
    "coding": [
      {
        "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/social-status-cs",
        "code": "regis0010.00003",
        "display": "Ishlaydi"
      }
    ]
  },
  "effectiveDateTime": "2025-06-11"
}

Choosing the type code and its value set

The only thing that changes between a benefits, education, profession, or social-status record is the SNOMED code and the matching valueCodeableConcept system. Keep the two in step - the result code system below must match the type code in the same row. Each system links to the value set of codes you can use:

For an occupation record, the code is 14679004 (Occupation) and the result comes from the profession code system:

{
  "resourceType": "Observation",
  "language": "uz",
  "meta": {
    "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-socioeconomic-observation" ]
  },
  "status": "final",
  "code": {
    "coding": [
      { "system": "http://snomed.info/sct", "code": "14679004", "display": "Occupation" }
    ]
  },
  "subject": { "reference": "Patient/example-salim" },
  "valueCodeableConcept": {
    "coding": [
      {
        "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs",
        "code": "1321.20",
        "display": "Bosh mexanik"
      }
    ]
  },
  "effectiveDateTime": "2025-06-11"
}

See Terminology for how the bound value sets are published.

For example API calls and a sample payload, see the Quick Start at the bottom of this page.

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

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Observation	C	0..*	Observation(5.0.0)	Measurements and simple assertions Constraints: obs-6, obs-7, obs-8
Observation.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
Observation.contained		0..*	Resource	Contained, inline Resources
Observation.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored Constraints: ext-1
Observation.status	?! This element is a modifier element. Σ This element is included in summaries.	1..1	code	registered | preliminary | final | amended + Binding: ObservationStatus (required): Codes providing the status of an observation.
Observation.code	S This element must be supported. Σ This element is included in summaries. C	1..1	CodeableConcept	Socioeconomic observation type. Education level code is aligned with EE MPI SocialHistory Education Level profile Binding: LOINCCodes (example): Codes identifying names of simple observations.
Observation.code.Slices for coding	Σ This element is included in summaries.	1..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Observation.code.Slices for coding.coding:socioeconomicType	S This element must be supported. Σ This element is included in summaries.	1..1	Coding	Required socioeconomic observation type code Binding: SocioeconomicObservationCodesVS (0.12.0) (required)
Observation.code.Slices for coding.coding:socioeconomicType.system	Σ This element is included in summaries.	0..1	uri	Identity of the terminology system Required Pattern: http://snomed.info/sct (extensions allowed)
Observation.subject	S This element must be supported. Σ This element is included in summaries.	1..1	Reference(UZ Core Patient(0.12.0))	Who and/or what the observation is about
Observation.Slices for effective[x]	Σ This element is included in summaries.	1..1	dateTime	Clinically relevant time/time-period for observation Slice: Unordered, Closed by type:$this Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Observation.Slices for effective[x].effective[x]:effectiveDateTime	S This element must be supported. Σ This element is included in summaries.	1..1	dateTime	Date when the socioeconomic data was recorded or applicable
Observation.value[x]	Σ This element is included in summaries. C	0..1	CodeableConcept	One of the sample valuesets that can be used is BenefitsVS. For all others, see the table: Binding: BenefitsVS (0.12.0) (example) Additional Bindings Purpose Usage BenefitsVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 1303306008 (Eligible for benefit) EducationVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 105421008 (Educational achievement) PositionAndProfessionVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 14679004 (Occupation) SocialStatusVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 82996008 (Social status)
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Observation.status	Base	required	Observation Status	📍5.0.0	FHIR Std.
Observation.code	Base	example	LOINC Codes	📍5.0.0	FHIR Std.
Observation.code.coding:socioeconomicType	Base	required	Socioeconomic observation code	📍0.12.0	This IG
Observation.value[x]	Base	example	Benefit	📍0.12.0	This IG

Constraints

Id

Grade

Path(s)

Description

Expression

This structure is derived from Observation

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Observation		0..*	Observation(5.0.0)	Measurements and simple assertions
Observation.code	S This element must be supported.	1..1	CodeableConcept	Socioeconomic observation type. Education level code is aligned with EE MPI SocialHistory Education Level profile
Observation.code.Slices for coding		1..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Observation.code.Slices for coding.coding:socioeconomicType	S This element must be supported.	1..1	Coding	Required socioeconomic observation type code Binding: SocioeconomicObservationCodesVS (0.12.0) (required)
Observation.code.Slices for coding.coding:socioeconomicType.system		0..1	uri	Identity of the terminology system Required Pattern: http://snomed.info/sct (extensions allowed)
Observation.subject	S This element must be supported.	1..1	Reference(UZ Core Patient(0.12.0))	Who and/or what the observation is about
Observation.Slices for effective[x]		1..1	dateTime	Clinically relevant time/time-period for observation Slice: Unordered, Open by type:$this Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Observation.Slices for effective[x].effective[x]:effectiveDateTime	S This element must be supported.	1..1	dateTime	Date when the socioeconomic data was recorded or applicable
Observation.value[x]		0..1	CodeableConcept	One of the sample valuesets that can be used is BenefitsVS. For all others, see the table: Binding: BenefitsVS (0.12.0) (example) Additional Bindings Purpose Usage BenefitsVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 1303306008 (Eligible for benefit) EducationVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 105421008 (Educational achievement) PositionAndProfessionVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 14679004 (Occupation) SocialStatusVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 82996008 (Social status)
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Observation.code.coding:socioeconomicType	Base	required	Socioeconomic observation code	📍0.12.0	This IG
Observation.value[x]	Base	example	Benefit	📍0.12.0	This IG

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Observation	C	0..*	Observation(5.0.0)	Measurements and simple assertions Constraints: obs-6, obs-7, obs-8
Observation.id	Σ This element is included in summaries.	0..1	id	Logical id of this artifact
Observation.meta	Σ This element is included in summaries.	0..1	Meta	Metadata about the resource
Observation.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
Observation.language		0..1	code	Language of the resource content Binding: AllLanguages (required): IETF language tag for a human language Additional Bindings Purpose CommonLanguages Starter
Observation.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
Observation.contained		0..*	Resource	Contained, inline Resources
Observation.extension		0..*	Extension	Additional content defined by implementations Constraints: ext-1
Observation.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored Constraints: ext-1
Observation.identifier	Σ This element is included in summaries.	0..*	Identifier	Business Identifier for observation
Observation.instantiates[x]	Σ This element is included in summaries.	0..1	canonical(ObservationDefinition), Reference(ObservationDefinition)	Instantiates FHIR ObservationDefinition
Observation.basedOn	Σ This element is included in summaries.	0..*	Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)	Fulfills plan, proposal or order
Observation.triggeredBy		0..*	BackboneElement	Triggering observation(s)
Observation.triggeredBy.id		0..1	string	Unique id for inter-element referencing
Observation.triggeredBy.extension		0..*	Extension	Additional content defined by implementations Constraints: ext-1
Observation.triggeredBy.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
Observation.triggeredBy.observation	Σ This element is included in summaries.	1..1	Reference(Observation)	Triggering observation
Observation.triggeredBy.type	Σ This element is included in summaries.	1..1	code	reflex | repeat | re-run Binding: TriggeredBytype (required): The type of TriggeredBy Observation.
Observation.triggeredBy.reason		0..1	string	Reason that the observation was triggered
Observation.partOf	Σ This element is included in summaries.	0..*	Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy | GenomicStudy)	Part of referenced event
Observation.status	?! This element is a modifier element. Σ This element is included in summaries.	1..1	code	registered | preliminary | final | amended + Binding: ObservationStatus (required): Codes providing the status of an observation.
Observation.category		0..*	CodeableConcept	Classification of type of observation Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.
Observation.code	S This element must be supported. Σ This element is included in summaries. C	1..1	CodeableConcept	Socioeconomic observation type. Education level code is aligned with EE MPI SocialHistory Education Level profile Binding: LOINCCodes (example): Codes identifying names of simple observations.
Observation.code.id		0..1	id	Unique id for inter-element referencing
Observation.code.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
Observation.code.Slices for coding	Σ This element is included in summaries.	1..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Observation.code.Slices for coding.coding:socioeconomicType	S This element must be supported. Σ This element is included in summaries.	1..1	Coding	Required socioeconomic observation type code Binding: SocioeconomicObservationCodesVS (0.12.0) (required)
Observation.code.Slices for coding.coding:socioeconomicType.id		0..1	id	Unique id for inter-element referencing
Observation.code.Slices for coding.coding:socioeconomicType.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
Observation.code.Slices for coding.coding:socioeconomicType.system	Σ This element is included in summaries.	0..1	uri	Identity of the terminology system Required Pattern: http://snomed.info/sct (extensions allowed)
Observation.code.Slices for coding.coding:socioeconomicType.version	Σ This element is included in summaries.	0..1	string	Version of the system - if relevant
Observation.code.Slices for coding.coding:socioeconomicType.code	Σ This element is included in summaries. C	0..1	code	Symbol in syntax defined by the system
Observation.code.Slices for coding.coding:socioeconomicType.display	Σ This element is included in summaries. C	0..1	string	Representation defined by the system
Observation.code.Slices for coding.coding:socioeconomicType.userSelected	Σ This element is included in summaries.	0..1	boolean	If this coding was chosen directly by the user
Observation.code.text	Σ This element is included in summaries.	0..1	string	Plain text representation of the concept
Observation.subject	S This element must be supported. Σ This element is included in summaries.	1..1	Reference(UZ Core Patient(0.12.0))	Who and/or what the observation is about
Observation.focus	Σ This element is included in summaries.	0..*	Reference(Resource)	What the observation is about, when it is not about the subject of record
Observation.encounter	Σ This element is included in summaries.	0..1	Reference(Encounter)	Healthcare event during which this observation is made
Observation.Slices for effective[x]	Σ This element is included in summaries.	1..1	dateTime	Clinically relevant time/time-period for observation Slice: Unordered, Closed by type:$this Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Observation.Slices for effective[x].effective[x]:effectiveDateTime	S This element must be supported. Σ This element is included in summaries.	1..1	dateTime	Date when the socioeconomic data was recorded or applicable
Observation.issued	Σ This element is included in summaries.	0..1	instant	Date/Time this version was made available
Observation.performer	Σ This element is included in summaries.	0..*	Reference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | RelatedPerson)	Who is responsible for the observation
Observation.value[x]	Σ This element is included in summaries. C	0..1	CodeableConcept	One of the sample valuesets that can be used is BenefitsVS. For all others, see the table: Binding: BenefitsVS (0.12.0) (example) Additional Bindings Purpose Usage BenefitsVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 1303306008 (Eligible for benefit) EducationVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 105421008 (Educational achievement) PositionAndProfessionVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 14679004 (Occupation) SocialStatusVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 82996008 (Social status)
Observation.dataAbsentReason	C	0..1	CodeableConcept	Why the result is missing Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.
Observation.interpretation		0..*	CodeableConcept	High, low, normal, etc Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations.
Observation.note		0..*	Annotation	Comments about the observation
Observation.bodySite	C	0..1	CodeableConcept	Observed body part Binding: SNOMEDCTBodyStructures (example): SNOMED CT Body site concepts
Observation.bodyStructure	C	0..1	Reference(BodyStructure)	Observed body structure
Observation.method		0..1	CodeableConcept	How it was done Binding: ObservationMethods (example): Methods for simple observations.
Observation.specimen	C	0..1	Reference(Specimen | Group)	Specimen used for this observation Constraints: obs-9
Observation.device		0..1	Reference(Device | DeviceMetric)	A reference to the device that generates the measurements or the device settings for the device
Observation.referenceRange	C	0..*	BackboneElement	Provides guide for interpretation Constraints: obs-3
Observation.referenceRange.id		0..1	string	Unique id for inter-element referencing
Observation.referenceRange.extension		0..*	Extension	Additional content defined by implementations Constraints: ext-1
Observation.referenceRange.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
Observation.referenceRange.low	C	0..1	SimpleQuantity(5.0.0)	Low Range, if relevant Constraints: sqty-1
Observation.referenceRange.high	C	0..1	SimpleQuantity(5.0.0)	High Range, if relevant Constraints: sqty-1
Observation.referenceRange.normalValue		0..1	CodeableConcept	Normal value, if relevant Binding: ObservationReferenceRangeNormalValueCodes (extensible): Codes identifying the normal value of the observation.
Observation.referenceRange.type		0..1	CodeableConcept	Reference range qualifier Binding: ObservationReferenceRangeMeaningCodes (preferred): Code for the meaning of a reference range.
Observation.referenceRange.appliesTo		0..*	CodeableConcept	Reference range population Binding: ObservationReferenceRangeAppliesToCodes (example): Codes identifying the population the reference range applies to.
Observation.referenceRange.age		0..1	Range	Applicable age range, if relevant
Observation.referenceRange.text	C	0..1	markdown	Text based reference range in an observation
Observation.hasMember	Σ This element is included in summaries.	0..*	Reference(Observation | QuestionnaireResponse | MolecularSequence)	Related resource that belongs to the Observation group
Observation.derivedFrom	Σ This element is included in summaries.	0..*	Reference(DocumentReference | ImagingStudy | ImagingSelection | QuestionnaireResponse | Observation | MolecularSequence | GenomicStudy)	Related resource from which the observation is made
Observation.component	Σ This element is included in summaries. C	0..*	BackboneElement	Component results
Observation.component.id		0..1	string	Unique id for inter-element referencing
Observation.component.extension		0..*	Extension	Additional content defined by implementations Constraints: ext-1
Observation.component.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
Observation.component.code	Σ This element is included in summaries. C	1..1	CodeableConcept	Type of component observation (code / type) Binding: LOINCCodes (example): Codes identifying names of simple observations.
Observation.component.value[x]	Σ This element is included in summaries.	0..1		Actual component result
Observation.component.value[x].valueQuantity			Quantity
Observation.component.value[x].valueCodeableConcept			CodeableConcept
Observation.component.value[x].valueString			string
Observation.component.value[x].valueBoolean			boolean
Observation.component.value[x].valueInteger			integer
Observation.component.value[x].valueRange			Range
Observation.component.value[x].valueRatio			Ratio
Observation.component.value[x].valueSampledData			SampledData
Observation.component.value[x].valueTime			time
Observation.component.value[x].valueDateTime			dateTime
Observation.component.value[x].valuePeriod			Period
Observation.component.value[x].valueAttachment			Attachment
Observation.component.value[x].valueReference			Reference(MolecularSequence)
Observation.component.dataAbsentReason		0..1	CodeableConcept	Why the component result is missing Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.
Observation.component.interpretation		0..*	CodeableConcept	High, low, normal, etc Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations.
Observation.component.referenceRange		0..*	See referenceRange (Observation)	Provides guide for interpretation of component result
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Observation.language	Base	required	All Languages	📍5.0.0	FHIR Std.
Observation.triggeredBy.​type	Base	required	triggered Bytype	📍5.0.0	FHIR Std.
Observation.status	Base	required	Observation Status	📍5.0.0	FHIR Std.
Observation.category	Base	preferred	Observation Category Codes	📍5.0.0	FHIR Std.
Observation.code	Base	example	LOINC Codes	📍5.0.0	FHIR Std.
Observation.code.coding:socioeconomicType	Base	required	Socioeconomic observation code	📍0.12.0	This IG
Observation.value[x]	Base	example	Benefit	📍0.12.0	This IG
Observation.dataAbsentReason	Base	extensible	Data Absent Reason	📍5.0.0	FHIR Std.
Observation.interpretation	Base	extensible	Observation Interpretation Codes	📍5.0.0	FHIR Std.
Observation.bodySite	Base	example	SNOMED CT Body Structures	📍5.0.0	FHIR Std.
Observation.method	Base	example	Observation Methods	📍5.0.0	FHIR Std.
Observation.referenceRange.​normalValue	Base	extensible	Observation Reference Range Normal Value Codes	📍5.0.0	FHIR Std.
Observation.referenceRange.​type	Base	preferred	Observation Reference Range Meaning Codes	📍5.0.0	FHIR Std.
Observation.referenceRange.​appliesTo	Base	example	Observation Reference Range Applies To Codes	📍5.0.0	FHIR Std.
Observation.component.​code	Base	example	LOINC Codes	📍5.0.0	FHIR Std.
Observation.component.​dataAbsentReason	Base	extensible	Data Absent Reason	📍5.0.0	FHIR Std.
Observation.component.​interpretation	Base	extensible	Observation Interpretation Codes	📍5.0.0	FHIR Std.

Constraints

Id

Grade

Path(s)

Description

Expression

Key Elements View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Observation	C	0..*	Observation(5.0.0)	Measurements and simple assertions Constraints: obs-6, obs-7, obs-8
Observation.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
Observation.contained		0..*	Resource	Contained, inline Resources
Observation.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored Constraints: ext-1
Observation.status	?! This element is a modifier element. Σ This element is included in summaries.	1..1	code	registered | preliminary | final | amended + Binding: ObservationStatus (required): Codes providing the status of an observation.
Observation.code	S This element must be supported. Σ This element is included in summaries. C	1..1	CodeableConcept	Socioeconomic observation type. Education level code is aligned with EE MPI SocialHistory Education Level profile Binding: LOINCCodes (example): Codes identifying names of simple observations.
Observation.code.Slices for coding	Σ This element is included in summaries.	1..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Observation.code.Slices for coding.coding:socioeconomicType	S This element must be supported. Σ This element is included in summaries.	1..1	Coding	Required socioeconomic observation type code Binding: SocioeconomicObservationCodesVS (0.12.0) (required)
Observation.code.Slices for coding.coding:socioeconomicType.system	Σ This element is included in summaries.	0..1	uri	Identity of the terminology system Required Pattern: http://snomed.info/sct (extensions allowed)
Observation.subject	S This element must be supported. Σ This element is included in summaries.	1..1	Reference(UZ Core Patient(0.12.0))	Who and/or what the observation is about
Observation.Slices for effective[x]	Σ This element is included in summaries.	1..1	dateTime	Clinically relevant time/time-period for observation Slice: Unordered, Closed by type:$this Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Observation.Slices for effective[x].effective[x]:effectiveDateTime	S This element must be supported. Σ This element is included in summaries.	1..1	dateTime	Date when the socioeconomic data was recorded or applicable
Observation.value[x]	Σ This element is included in summaries. C	0..1	CodeableConcept	One of the sample valuesets that can be used is BenefitsVS. For all others, see the table: Binding: BenefitsVS (0.12.0) (example) Additional Bindings Purpose Usage BenefitsVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 1303306008 (Eligible for benefit) EducationVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 105421008 (Educational achievement) PositionAndProfessionVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 14679004 (Occupation) SocialStatusVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 82996008 (Social status)
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Observation.status	Base	required	Observation Status	📍5.0.0	FHIR Std.
Observation.code	Base	example	LOINC Codes	📍5.0.0	FHIR Std.
Observation.code.coding:socioeconomicType	Base	required	Socioeconomic observation code	📍0.12.0	This IG
Observation.value[x]	Base	example	Benefit	📍0.12.0	This IG

Constraints

Id

Grade

Path(s)

Description

Expression

Differential View

This structure is derived from Observation

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Observation		0..*	Observation(5.0.0)	Measurements and simple assertions
Observation.code	S This element must be supported.	1..1	CodeableConcept	Socioeconomic observation type. Education level code is aligned with EE MPI SocialHistory Education Level profile
Observation.code.Slices for coding		1..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Observation.code.Slices for coding.coding:socioeconomicType	S This element must be supported.	1..1	Coding	Required socioeconomic observation type code Binding: SocioeconomicObservationCodesVS (0.12.0) (required)
Observation.code.Slices for coding.coding:socioeconomicType.system		0..1	uri	Identity of the terminology system Required Pattern: http://snomed.info/sct (extensions allowed)
Observation.subject	S This element must be supported.	1..1	Reference(UZ Core Patient(0.12.0))	Who and/or what the observation is about
Observation.Slices for effective[x]		1..1	dateTime	Clinically relevant time/time-period for observation Slice: Unordered, Open by type:$this Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Observation.Slices for effective[x].effective[x]:effectiveDateTime	S This element must be supported.	1..1	dateTime	Date when the socioeconomic data was recorded or applicable
Observation.value[x]		0..1	CodeableConcept	One of the sample valuesets that can be used is BenefitsVS. For all others, see the table: Binding: BenefitsVS (0.12.0) (example) Additional Bindings Purpose Usage BenefitsVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 1303306008 (Eligible for benefit) EducationVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 105421008 (Educational achievement) PositionAndProfessionVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 14679004 (Occupation) SocialStatusVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 82996008 (Social status)
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
Observation.code.coding:socioeconomicType	Base	required	Socioeconomic observation code	📍0.12.0	This IG
Observation.value[x]	Base	example	Benefit	📍0.12.0	This IG

Snapshot ViewView

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Observation	C	0..*	Observation(5.0.0)	Measurements and simple assertions Constraints: obs-6, obs-7, obs-8
Observation.id	Σ This element is included in summaries.	0..1	id	Logical id of this artifact
Observation.meta	Σ This element is included in summaries.	0..1	Meta	Metadata about the resource
Observation.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
Observation.language		0..1	code	Language of the resource content Binding: AllLanguages (required): IETF language tag for a human language Additional Bindings Purpose CommonLanguages Starter
Observation.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
Observation.contained		0..*	Resource	Contained, inline Resources
Observation.extension		0..*	Extension	Additional content defined by implementations Constraints: ext-1
Observation.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored Constraints: ext-1
Observation.identifier	Σ This element is included in summaries.	0..*	Identifier	Business Identifier for observation
Observation.instantiates[x]	Σ This element is included in summaries.	0..1	canonical(ObservationDefinition), Reference(ObservationDefinition)	Instantiates FHIR ObservationDefinition
Observation.basedOn	Σ This element is included in summaries.	0..*	Reference(CarePlan | DeviceRequest | ImmunizationRecommendation | MedicationRequest | NutritionOrder | ServiceRequest)	Fulfills plan, proposal or order
Observation.triggeredBy		0..*	BackboneElement	Triggering observation(s)
Observation.triggeredBy.id		0..1	string	Unique id for inter-element referencing
Observation.triggeredBy.extension		0..*	Extension	Additional content defined by implementations Constraints: ext-1
Observation.triggeredBy.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
Observation.triggeredBy.observation	Σ This element is included in summaries.	1..1	Reference(Observation)	Triggering observation
Observation.triggeredBy.type	Σ This element is included in summaries.	1..1	code	reflex | repeat | re-run Binding: TriggeredBytype (required): The type of TriggeredBy Observation.
Observation.triggeredBy.reason		0..1	string	Reason that the observation was triggered
Observation.partOf	Σ This element is included in summaries.	0..*	Reference(MedicationAdministration | MedicationDispense | MedicationStatement | Procedure | Immunization | ImagingStudy | GenomicStudy)	Part of referenced event
Observation.status	?! This element is a modifier element. Σ This element is included in summaries.	1..1	code	registered | preliminary | final | amended + Binding: ObservationStatus (required): Codes providing the status of an observation.
Observation.category		0..*	CodeableConcept	Classification of type of observation Binding: ObservationCategoryCodes (preferred): Codes for high level observation categories.
Observation.code	S This element must be supported. Σ This element is included in summaries. C	1..1	CodeableConcept	Socioeconomic observation type. Education level code is aligned with EE MPI SocialHistory Education Level profile Binding: LOINCCodes (example): Codes identifying names of simple observations.
Observation.code.id		0..1	id	Unique id for inter-element referencing
Observation.code.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
Observation.code.Slices for coding	Σ This element is included in summaries.	1..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Observation.code.Slices for coding.coding:socioeconomicType	S This element must be supported. Σ This element is included in summaries.	1..1	Coding	Required socioeconomic observation type code Binding: SocioeconomicObservationCodesVS (0.12.0) (required)
Observation.code.Slices for coding.coding:socioeconomicType.id		0..1	id	Unique id for inter-element referencing
Observation.code.Slices for coding.coding:socioeconomicType.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
Observation.code.Slices for coding.coding:socioeconomicType.system	Σ This element is included in summaries.	0..1	uri	Identity of the terminology system Required Pattern: http://snomed.info/sct (extensions allowed)
Observation.code.Slices for coding.coding:socioeconomicType.version	Σ This element is included in summaries.	0..1	string	Version of the system - if relevant
Observation.code.Slices for coding.coding:socioeconomicType.code	Σ This element is included in summaries. C	0..1	code	Symbol in syntax defined by the system
Observation.code.Slices for coding.coding:socioeconomicType.display	Σ This element is included in summaries. C	0..1	string	Representation defined by the system
Observation.code.Slices for coding.coding:socioeconomicType.userSelected	Σ This element is included in summaries.	0..1	boolean	If this coding was chosen directly by the user
Observation.code.text	Σ This element is included in summaries.	0..1	string	Plain text representation of the concept
Observation.subject	S This element must be supported. Σ This element is included in summaries.	1..1	Reference(UZ Core Patient(0.12.0))	Who and/or what the observation is about
Observation.focus	Σ This element is included in summaries.	0..*	Reference(Resource)	What the observation is about, when it is not about the subject of record
Observation.encounter	Σ This element is included in summaries.	0..1	Reference(Encounter)	Healthcare event during which this observation is made
Observation.Slices for effective[x]	Σ This element is included in summaries.	1..1	dateTime	Clinically relevant time/time-period for observation Slice: Unordered, Closed by type:$this Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Observation.Slices for effective[x].effective[x]:effectiveDateTime	S This element must be supported. Σ This element is included in summaries.	1..1	dateTime	Date when the socioeconomic data was recorded or applicable
Observation.issued	Σ This element is included in summaries.	0..1	instant	Date/Time this version was made available
Observation.performer	Σ This element is included in summaries.	0..*	Reference(Practitioner | PractitionerRole | Organization | CareTeam | Patient | RelatedPerson)	Who is responsible for the observation
Observation.value[x]	Σ This element is included in summaries. C	0..1	CodeableConcept	One of the sample valuesets that can be used is BenefitsVS. For all others, see the table: Binding: BenefitsVS (0.12.0) (example) Additional Bindings Purpose Usage BenefitsVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 1303306008 (Eligible for benefit) EducationVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 105421008 (Educational achievement) PositionAndProfessionVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 14679004 (Occupation) SocialStatusVS (0.12.0) Required UZCoreSocioeconomicObservation#Observation.code = SNOMED CT: 82996008 (Social status)
Observation.dataAbsentReason	C	0..1	CodeableConcept	Why the result is missing Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.
Observation.interpretation		0..*	CodeableConcept	High, low, normal, etc Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations.
Observation.note		0..*	Annotation	Comments about the observation
Observation.bodySite	C	0..1	CodeableConcept	Observed body part Binding: SNOMEDCTBodyStructures (example): SNOMED CT Body site concepts
Observation.bodyStructure	C	0..1	Reference(BodyStructure)	Observed body structure
Observation.method		0..1	CodeableConcept	How it was done Binding: ObservationMethods (example): Methods for simple observations.
Observation.specimen	C	0..1	Reference(Specimen | Group)	Specimen used for this observation Constraints: obs-9
Observation.device		0..1	Reference(Device | DeviceMetric)	A reference to the device that generates the measurements or the device settings for the device
Observation.referenceRange	C	0..*	BackboneElement	Provides guide for interpretation Constraints: obs-3
Observation.referenceRange.id		0..1	string	Unique id for inter-element referencing
Observation.referenceRange.extension		0..*	Extension	Additional content defined by implementations Constraints: ext-1
Observation.referenceRange.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
Observation.referenceRange.low	C	0..1	SimpleQuantity(5.0.0)	Low Range, if relevant Constraints: sqty-1
Observation.referenceRange.high	C	0..1	SimpleQuantity(5.0.0)	High Range, if relevant Constraints: sqty-1
Observation.referenceRange.normalValue		0..1	CodeableConcept	Normal value, if relevant Binding: ObservationReferenceRangeNormalValueCodes (extensible): Codes identifying the normal value of the observation.
Observation.referenceRange.type		0..1	CodeableConcept	Reference range qualifier Binding: ObservationReferenceRangeMeaningCodes (preferred): Code for the meaning of a reference range.
Observation.referenceRange.appliesTo		0..*	CodeableConcept	Reference range population Binding: ObservationReferenceRangeAppliesToCodes (example): Codes identifying the population the reference range applies to.
Observation.referenceRange.age		0..1	Range	Applicable age range, if relevant
Observation.referenceRange.text	C	0..1	markdown	Text based reference range in an observation
Observation.hasMember	Σ This element is included in summaries.	0..*	Reference(Observation | QuestionnaireResponse | MolecularSequence)	Related resource that belongs to the Observation group
Observation.derivedFrom	Σ This element is included in summaries.	0..*	Reference(DocumentReference | ImagingStudy | ImagingSelection | QuestionnaireResponse | Observation | MolecularSequence | GenomicStudy)	Related resource from which the observation is made
Observation.component	Σ This element is included in summaries. C	0..*	BackboneElement	Component results
Observation.component.id		0..1	string	Unique id for inter-element referencing
Observation.component.extension		0..*	Extension	Additional content defined by implementations Constraints: ext-1
Observation.component.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized Constraints: ext-1
Observation.component.code	Σ This element is included in summaries. C	1..1	CodeableConcept	Type of component observation (code / type) Binding: LOINCCodes (example): Codes identifying names of simple observations.
Observation.component.value[x]	Σ This element is included in summaries.	0..1		Actual component result
Observation.component.value[x].valueQuantity			Quantity
Observation.component.value[x].valueCodeableConcept			CodeableConcept
Observation.component.value[x].valueString			string
Observation.component.value[x].valueBoolean			boolean
Observation.component.value[x].valueInteger			integer
Observation.component.value[x].valueRange			Range
Observation.component.value[x].valueRatio			Ratio
Observation.component.value[x].valueSampledData			SampledData
Observation.component.value[x].valueTime			time
Observation.component.value[x].valueDateTime			dateTime
Observation.component.value[x].valuePeriod			Period
Observation.component.value[x].valueAttachment			Attachment
Observation.component.value[x].valueReference			Reference(MolecularSequence)
Observation.component.dataAbsentReason		0..1	CodeableConcept	Why the component result is missing Binding: DataAbsentReason (extensible): Codes specifying why the result (Observation.value[x]) is missing.
Observation.component.interpretation		0..*	CodeableConcept	High, low, normal, etc Binding: ObservationInterpretationCodes (extensible): Codes identifying interpretations of observations.
Observation.component.referenceRange		0..*	See referenceRange (Observation)	Provides guide for interpretation of component result
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Observation.language	Base	required	All Languages	📍5.0.0	FHIR Std.
Observation.triggeredBy.​type	Base	required	triggered Bytype	📍5.0.0	FHIR Std.
Observation.status	Base	required	Observation Status	📍5.0.0	FHIR Std.
Observation.category	Base	preferred	Observation Category Codes	📍5.0.0	FHIR Std.
Observation.code	Base	example	LOINC Codes	📍5.0.0	FHIR Std.
Observation.code.coding:socioeconomicType	Base	required	Socioeconomic observation code	📍0.12.0	This IG
Observation.value[x]	Base	example	Benefit	📍0.12.0	This IG
Observation.dataAbsentReason	Base	extensible	Data Absent Reason	📍5.0.0	FHIR Std.
Observation.interpretation	Base	extensible	Observation Interpretation Codes	📍5.0.0	FHIR Std.
Observation.bodySite	Base	example	SNOMED CT Body Structures	📍5.0.0	FHIR Std.
Observation.method	Base	example	Observation Methods	📍5.0.0	FHIR Std.
Observation.referenceRange.​normalValue	Base	extensible	Observation Reference Range Normal Value Codes	📍5.0.0	FHIR Std.
Observation.referenceRange.​type	Base	preferred	Observation Reference Range Meaning Codes	📍5.0.0	FHIR Std.
Observation.referenceRange.​appliesTo	Base	example	Observation Reference Range Applies To Codes	📍5.0.0	FHIR Std.
Observation.component.​code	Base	example	LOINC Codes	📍5.0.0	FHIR Std.
Observation.component.​dataAbsentReason	Base	extensible	Data Absent Reason	📍5.0.0	FHIR Std.
Observation.component.​interpretation	Base	extensible	Observation Interpretation Codes	📍5.0.0	FHIR Std.

Constraints

Id

Grade

Path(s)

Description

Expression

This structure is derived from Observation

Summary

Mandatory: 5 elements
Must-Support: 4 elements

Structures

This structure refers to these other structures:

• UZ Core Patient (https://dhp.uz/fhir/core/StructureDefinition/uz-core-patient|0.12.0)

Slices

This structure defines the following Slices:

• The element 1 is sliced based on the value of Observation.code.coding
• The element 1 is sliced based on the value of Observation.effective[x]

Quick Start

This profile is on Observation, so use the Observation endpoint. [base] is the FHIR server base URL; | separates system from value and must be URL-encoded as %7C.

Read by server id

GET [base]/Observation/[id]

Find socioeconomic observations

GET [base]/Observation?patient=Patient/[id]&category=social-history
GET [base]/Observation?patient=Patient/[id]&code=http://snomed.info/sct%7C1303306008
GET [base]/Observation?patient=Patient/[id]&date=ge2025-01-01
GET [base]/Observation?patient=Patient/[id]&status=final

Create

POST [base]/Observation
{
  "resourceType": "Observation",
  "meta": {
    "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-socioeconomic-observation" ]
  },
  "status": "final",
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "1303306008",
        "display": "Eligible for benefit"
      }
    ]
  },
  "subject": { "reference": "Patient/[id]" },
  "effectiveDateTime": "2025-06-11",
  ...
}

Update (e.g. correct a recorded value by setting status to corrected) - PUT the full resource back with the new status / value[x]:

PUT [base]/Observation/[id]
If-Match: W/"3"   # the ETag from your last read; 412 if it changed since

See the CapabilityStatement for all supported search parameters.

Related

• How to read this guide · Must Support · General guidance
• Workflows