This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions 
Responsible Owner: Orders and Observations Work Group | Normative | Security Category: Patient | Compartments: Patient |
Record details about an anatomical structure. This resource may be used when a coded concept does not provide the necessary detail needed for the use case.
Note to Balloters: To ensure this resource is ready for Normative status, we are seeking ballot comment on the substantive content. The key changes made since R5 include:
- BodyStructure.morphology has been moved to BodyStructure.includedStructure.morphology
- Added BodyStructure.includedStructure.image to provide an image of the includedStructure or excludedStructure.
Release Notes (pending alternative process review with FMG):
The BodyStructure resource contain details about an anatomical or pathological structure (e.g. a cyst) and may include patient information, identifiers, text descriptions, images, and spatially relevant characteristics.
BodyStructure is used when a coded concept alone does not provide sufficient detail, identity, persistence, or reuse for the use case. It supports representation of complex anatomical structures and locations using included and excluded structures and can provide additional detail such as laterality, directionality, qualifiers, morphology, images, landmark-based positioning, and spatial references.
Some anatomical structures are discontiguous or consist of multiple related structures. A single BodyStructure instance may represent multiple included structures when they are considered a single anatomical or pathological entity for recording, tracking, or clinical management purposes. Separate BodyStructure instances should be used when structures need to be identified, assessed, tracked, treated, or managed independently over time.
The BodyStructure resource supports recording and tracking an anatomic location or structure on a patient outside the context of another resource.
A BodyStructure instance is appropriate when the anatomical structure or pathological structures need to be recorded and tracked outside the context of a single resource, reused across resources, or described with additional detail such as laterality, qualifiers, morphology, images, or spatial description.
The bodyStructure element in resources that support it can be used when the resource's code does not fully specify the relevant body structure. As a CodeableReference, it supports both simple coded body structure concepts and references to a BodyStructure instance when additional detail or site-specific identity is needed; repeating elements allow multiple body structures to be represented.
Referencing resources, such as Procedure or Observation, can use one or more BodyStructure instances to identify the relevant structures consistently across multiple records and over time.
Resources that support references to BodyStructure should generally allow multiple references where multiple anatomical or pathological structures may be relevant to the clinical context. A resource may reference multiple BodyStructure instances when the structures are distinct entities that need to be identified or managed independently. A single BodyStructure instance may represent multiple related structures through its includedStructure elements when those structures are treated as a single anatomical or pathological entity.
If a resource's code implies a body structure, any referenced BodyStructure should be consistent with that code and used to provide additional anatomical detail.
Structure
See the Extensions for this resource
UML Diagram (Legend)
XML Template
<BodyStructure xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Bodystructure identifier --></identifier> <active value="[boolean]"/><!-- 0..1 Whether this record is in active use --> <includedStructure> <!-- 1..* Included anatomic location(s) --> <structure><!-- 1..1 CodeableConcept Code that represents the included structure --></structure> <laterality><!-- 0..1 CodeableConcept Code that represents the included structure laterality --></laterality> <bodyLandmarkOrientation> <!-- 0..* Landmark relative location --> <landmarkDescription><!-- 0..* CodeableConcept Explanation of landmark --></landmarkDescription> <clockFacePosition><!-- 0..* CodeableConcept Clockface orientation --></clockFacePosition> <distanceFromLandmark> <!-- 0..* Landmark relative location --> <device><!-- 0..* CodeableReference(Device) Measurement device --></device> <value><!-- 0..* Quantity Measured distance from body landmark --></value> </distanceFromLandmark> <surfaceOrientation><!-- 0..* CodeableConcept Relative landmark surface orientation --></surfaceOrientation> </bodyLandmarkOrientation> <spatialReference><!-- 0..* Reference(ImagingSelection) Cartesian reference for structure --></spatialReference> <image><!-- 0..* Attachment Image(s) of structural aspects --></image> <qualifier><!-- 0..* CodeableConcept Code that represents the included structure qualifier --></qualifier> <morphology><!-- 0..1 CodeableConcept Kind of Structure --></morphology> </includedStructure> <excludedStructure><!-- 0..* Content as for BodyStructure.includedStructure Excluded anatomic locations(s) --></excludedStructure> <description value="[markdown]"/><!-- 0..1 Text description --> <image><!-- 0..* Attachment Attached images --></image> <patient><!-- 0..1 Reference(Patient) Who this is about --></patient> </BodyStructure>
JSON Template
{
"resourceType" : "BodyStructure",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Bodystructure identifier
"active" : <boolean>, // Whether this record is in active use
"includedStructure" : [{ // R! Included anatomic location(s)
"structure" : { CodeableConcept }, // R! Code that represents the included structure
"laterality" : { CodeableConcept }, // Code that represents the included structure laterality
"bodyLandmarkOrientation" : [{ // Landmark relative location
"landmarkDescription" : [{ CodeableConcept }], // Explanation of landmark
"clockFacePosition" : [{ CodeableConcept }], // Clockface orientation
"distanceFromLandmark" : [{ // Landmark relative location
"device" : [{ CodeableReference(Device) }], // Measurement device
"value" : [{ Quantity }] // Measured distance from body landmark
}],
"surfaceOrientation" : [{ CodeableConcept }] // Relative landmark surface orientation
}],
"spatialReference" : [{ Reference(ImagingSelection) }], // Cartesian reference for structure
"image" : [{ Attachment }], // Image(s) of structural aspects
"qualifier" : [{ CodeableConcept }], // Code that represents the included structure qualifier
"morphology" : { CodeableConcept } // Kind of Structure
}],
"excludedStructure" : [{ Content as for BodyStructure.includedStructure }], // Excluded anatomic locations(s)
"description" : "<markdown>", // Text description
"image" : [{ Attachment }], // Attached images
"patient" : { Reference(Patient) } // Who this is about
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:BodyStructure; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: fhir:id, fhir:meta, fhir:implicitRules, and fhir:language # from DomainResource: fhir:text, fhir:contained, fhir:extension, and fhir:modifierExtension fhir:identifier ( [ Identifier ] ... ) ; # 0..* Bodystructure identifier fhir:active [ boolean ] ; # 0..1 Whether this record is in active use fhir:includedStructure ( [ # 1..* Included anatomic location(s) fhir:structure [ CodeableConcept ] ; # 1..1 Code that represents the included structure fhir:laterality [ CodeableConcept ] ; # 0..1 Code that represents the included structure laterality fhir:bodyLandmarkOrientation ( [ # 0..* Landmark relative location fhir:landmarkDescription ( [ CodeableConcept ] ... ) ; # 0..* Explanation of landmark fhir:clockFacePosition ( [ CodeableConcept ] ... ) ; # 0..* Clockface orientation fhir:distanceFromLandmark ( [ # 0..* Landmark relative location fhir:device ( [ CodeableReference(Device) ] ... ) ; # 0..* Measurement device fhir:value ( [ Quantity ] ... ) ; # 0..* Measured distance from body landmark ] ... ) ; fhir:surfaceOrientation ( [ CodeableConcept ] ... ) ; # 0..* Relative landmark surface orientation ] ... ) ; fhir:spatialReference ( [ Reference(ImagingSelection) ] ... ) ; # 0..* Cartesian reference for structure fhir:image ( [ Attachment ] ... ) ; # 0..* Image(s) of structural aspects fhir:qualifier ( [ CodeableConcept ] ... ) ; # 0..* Code that represents the included structure qualifier fhir:morphology [ CodeableConcept ] ; # 0..1 Kind of Structure ] ... ) ; fhir:excludedStructure ( [ See BodyStructure.includedStructure ] ... ) ; # 0..* Excluded anatomic locations(s) fhir:description [ markdown ] ; # 0..1 Text description fhir:image ( [ Attachment ] ... ) ; # 0..* Attached images fhir:patient [ Reference(Patient) ] ; # 0..1 Who this is about ]
Changes from R5 to R6
| BodyStructure | |
| BodyStructure.includedStructure.image |
|
| BodyStructure.includedStructure.morphology |
|
| BodyStructure.patient |
|
Changes from R4 and R4B to R6
| BodyStructure | |
| BodyStructure.includedStructure |
|
| BodyStructure.includedStructure.structure |
|
| BodyStructure.includedStructure.laterality |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation.landmarkDescription |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation.clockFacePosition |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation.distanceFromLandmark |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation.distanceFromLandmark.device |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation.distanceFromLandmark.value |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation.surfaceOrientation |
|
| BodyStructure.includedStructure.spatialReference |
|
| BodyStructure.includedStructure.image |
|
| BodyStructure.includedStructure.qualifier |
|
| BodyStructure.includedStructure.morphology |
|
| BodyStructure.excludedStructure |
|
| BodyStructure.description |
|
| BodyStructure.patient |
|
| BodyStructure.location |
|
| BodyStructure.locationQualifier |
|
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.
Structure
See the Extensions for this resource
XML Template
<BodyStructure xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier Bodystructure identifier --></identifier> <active value="[boolean]"/><!-- 0..1 Whether this record is in active use --> <includedStructure> <!-- 1..* Included anatomic location(s) --> <structure><!-- 1..1 CodeableConcept Code that represents the included structure --></structure> <laterality><!-- 0..1 CodeableConcept Code that represents the included structure laterality --></laterality> <bodyLandmarkOrientation> <!-- 0..* Landmark relative location --> <landmarkDescription><!-- 0..* CodeableConcept Explanation of landmark --></landmarkDescription> <clockFacePosition><!-- 0..* CodeableConcept Clockface orientation --></clockFacePosition> <distanceFromLandmark> <!-- 0..* Landmark relative location --> <device><!-- 0..* CodeableReference(Device) Measurement device --></device> <value><!-- 0..* Quantity Measured distance from body landmark --></value> </distanceFromLandmark> <surfaceOrientation><!-- 0..* CodeableConcept Relative landmark surface orientation --></surfaceOrientation> </bodyLandmarkOrientation> <spatialReference><!-- 0..* Reference(ImagingSelection) Cartesian reference for structure --></spatialReference> <image><!-- 0..* Attachment Image(s) of structural aspects --></image> <qualifier><!-- 0..* CodeableConcept Code that represents the included structure qualifier --></qualifier> <morphology><!-- 0..1 CodeableConcept Kind of Structure --></morphology> </includedStructure> <excludedStructure><!-- 0..* Content as for BodyStructure.includedStructure Excluded anatomic locations(s) --></excludedStructure> <description value="[markdown]"/><!-- 0..1 Text description --> <image><!-- 0..* Attachment Attached images --></image> <patient><!-- 0..1 Reference(Patient) Who this is about --></patient> </BodyStructure>
JSON Template
{
"resourceType" : "BodyStructure",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // Bodystructure identifier
"active" : <boolean>, // Whether this record is in active use
"includedStructure" : [{ // R! Included anatomic location(s)
"structure" : { CodeableConcept }, // R! Code that represents the included structure
"laterality" : { CodeableConcept }, // Code that represents the included structure laterality
"bodyLandmarkOrientation" : [{ // Landmark relative location
"landmarkDescription" : [{ CodeableConcept }], // Explanation of landmark
"clockFacePosition" : [{ CodeableConcept }], // Clockface orientation
"distanceFromLandmark" : [{ // Landmark relative location
"device" : [{ CodeableReference(Device) }], // Measurement device
"value" : [{ Quantity }] // Measured distance from body landmark
}],
"surfaceOrientation" : [{ CodeableConcept }] // Relative landmark surface orientation
}],
"spatialReference" : [{ Reference(ImagingSelection) }], // Cartesian reference for structure
"image" : [{ Attachment }], // Image(s) of structural aspects
"qualifier" : [{ CodeableConcept }], // Code that represents the included structure qualifier
"morphology" : { CodeableConcept } // Kind of Structure
}],
"excludedStructure" : [{ Content as for BodyStructure.includedStructure }], // Excluded anatomic locations(s)
"description" : "<markdown>", // Text description
"image" : [{ Attachment }], // Attached images
"patient" : { Reference(Patient) } // Who this is about
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:BodyStructure; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: fhir:id, fhir:meta, fhir:implicitRules, and fhir:language # from DomainResource: fhir:text, fhir:contained, fhir:extension, and fhir:modifierExtension fhir:identifier ( [ Identifier ] ... ) ; # 0..* Bodystructure identifier fhir:active [ boolean ] ; # 0..1 Whether this record is in active use fhir:includedStructure ( [ # 1..* Included anatomic location(s) fhir:structure [ CodeableConcept ] ; # 1..1 Code that represents the included structure fhir:laterality [ CodeableConcept ] ; # 0..1 Code that represents the included structure laterality fhir:bodyLandmarkOrientation ( [ # 0..* Landmark relative location fhir:landmarkDescription ( [ CodeableConcept ] ... ) ; # 0..* Explanation of landmark fhir:clockFacePosition ( [ CodeableConcept ] ... ) ; # 0..* Clockface orientation fhir:distanceFromLandmark ( [ # 0..* Landmark relative location fhir:device ( [ CodeableReference(Device) ] ... ) ; # 0..* Measurement device fhir:value ( [ Quantity ] ... ) ; # 0..* Measured distance from body landmark ] ... ) ; fhir:surfaceOrientation ( [ CodeableConcept ] ... ) ; # 0..* Relative landmark surface orientation ] ... ) ; fhir:spatialReference ( [ Reference(ImagingSelection) ] ... ) ; # 0..* Cartesian reference for structure fhir:image ( [ Attachment ] ... ) ; # 0..* Image(s) of structural aspects fhir:qualifier ( [ CodeableConcept ] ... ) ; # 0..* Code that represents the included structure qualifier fhir:morphology [ CodeableConcept ] ; # 0..1 Kind of Structure ] ... ) ; fhir:excludedStructure ( [ See BodyStructure.includedStructure ] ... ) ; # 0..* Excluded anatomic locations(s) fhir:description [ markdown ] ; # 0..1 Text description fhir:image ( [ Attachment ] ... ) ; # 0..* Attached images fhir:patient [ Reference(Patient) ] ; # 0..1 Who this is about ]
Changes from R5 to R6
| BodyStructure | |
| BodyStructure.includedStructure.image |
|
| BodyStructure.includedStructure.morphology |
|
| BodyStructure.patient |
|
Changes from R4 and R4B to R6
| BodyStructure | |
| BodyStructure.includedStructure |
|
| BodyStructure.includedStructure.structure |
|
| BodyStructure.includedStructure.laterality |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation.landmarkDescription |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation.clockFacePosition |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation.distanceFromLandmark |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation.distanceFromLandmark.device |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation.distanceFromLandmark.value |
|
| BodyStructure.includedStructure.bodyLandmarkOrientation.surfaceOrientation |
|
| BodyStructure.includedStructure.spatialReference |
|
| BodyStructure.includedStructure.image |
|
| BodyStructure.includedStructure.qualifier |
|
| BodyStructure.includedStructure.morphology |
|
| BodyStructure.excludedStructure |
|
| BodyStructure.description |
|
| BodyStructure.patient |
|
| BodyStructure.location |
|
| BodyStructure.locationQualifier |
|
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.
Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis
| Path | ValueSet | Type | Documentation |
|---|---|---|---|
| BodyStructure.includedStructure.structure | SNOMEDCTBodyStructures | Example | This value set includes all codes from SNOMED CT |
| BodyStructure.includedStructure.laterality | BodystructureLaterality | Example | SNOMED-CT concepts modifying the laterality of the anatomic location |
| BodyStructure.includedStructure.bodyLandmarkOrientation.landmarkDescription | SNOMEDCTBodyStructures | Example | This value set includes all codes from SNOMED CT |
| BodyStructure.includedStructure.bodyLandmarkOrientation.clockFacePosition | BodystructureBodyLandmarkClockFacePosition | Example | Select SNOMED CT codes. A set of codes that describe a things orientation based on a hourly positions of a clock face. |
| BodyStructure.includedStructure.bodyLandmarkOrientation.distanceFromLandmark.device | DeviceType | Example | Codes used to identify medical devices. Includes concepts from SNOMED CT (http://www.snomed.org/) where concept is-a 49062001 (Device) and is provided as a suggestive example. |
| BodyStructure.includedStructure.bodyLandmarkOrientation.surfaceOrientation | BodystructureLocationQualifier | Preferred | SNOMED-CT concepts modifying the anatomic location |
| BodyStructure.includedStructure.qualifier | BodystructureLocationQualifier | Example | SNOMED-CT concepts modifying the anatomic location |
| BodyStructure.includedStructure.morphology | SNOMEDCTMorphologicAbnormalities | Example | This value set includes all codes from SNOMED CT |
Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
| Name | Type | Description | Expression | In Common |
| excluded_structure | token | Body site excludedStructure structure | BodyStructure.excludedStructure.structure | |
| identifier | token | Bodystructure identifier | BodyStructure.identifier | 58 Resources |
| included_structure | token | Body site includedStructure structure | BodyStructure.includedStructure.structure | |
| morphology | token | Kind of Structure | BodyStructure.includedStructure.morphology | |
| patient | reference | Who this is about | BodyStructure.patient (Patient) |
60 Resources |