Social Care Interoperability Platform FHIR Implementation Guide
Version: 0.1.0, Status: draft

Social Care Interoperability Platform FHIR Implementation Guide - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Logical Model: MODSNeed - Detailed Descriptions

Draft as of 2026-03-24

Definitions for the MODS-Need logical model.

Guidance on how to interpret the contents of this table can be foundhere

0. MODS-Need
Definition

MODS Definition: All health and care needs, including emotional, social, cultural, religious and spiritual needs, should be included in assessments about the care and treatment people receive.


Base definition for all elements in a resource.

ShortMODS NeedBase for all elements
Control0..*
This element is affected by the following invariants: ele-1
Is Modifierfalse
Logical ModelInstances of this logical model are not marked to be the target of a Reference
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
2. MODS-Need.id
Definition

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

ShortUnique id for inter-element referencing
Control0..1
Typestring
Is Modifierfalse
XML FormatIn the XML format, this property is represented as an attribute.
Summaryfalse
4. MODS-Need.extension
Definition

May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

ShortAdditional content defined by implementations
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Control0..*
TypeExtension
Is Modifierfalse
Summaryfalse
Alternate Namesextensions, user content
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
SlicingThis element introduces a set of slices on MODS-Need.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ url
  • 6. MODS-Need.subjectOfCare
    Definition

    Person the information is about

    ShortPerson the information is about
    Control1..1
    TypeReference(MODS Subject of Care)
    8. MODS-Need.careWorker
    Definition

    Care actor who will perform the activity or performed the action or made the observation.

    ShortCare actor who will perform the activity or performed the action or made the observation.
    Control0..*
    TypeReference(MODS Care Worker)
    10. MODS-Need.coding
    Definition

    A reference to a code defined by a terminology system.

    ShortA reference to a code defined by a terminology system.
    Control0..*
    BindingThe codes SHOULD be taken from MODS Wish, Need, Preference Coding from SNOMED CT: Social Context, Procedures, and Clinical Findings
    (preferred to https://metadata.phase2.scip.synanetics.cloud/fhir/r4/ValueSet/MODS-SocialProcedureFindings-1)
    TypeCoding
    12. MODS-Need.category
    Definition

    Care and support needs identified as part of a care assessment.

    ShortCategory
    Control1..1
    BindingThe codes SHALL be taken from MODS Need Category
    (required to https://metadata.phase2.scip.synanetics.cloud/fhir/r4/ValueSet/MODS-NeedCategory-1)
    TypeCoding
    14. MODS-Need.date
    Definition

    The date, month, year and century, or any combination of these elements, of an EVENT. This could be the date an observation was made, the date of an assessment or the date an action has been performed.

    ShortDate/Time
    Control1..1
    TypedateTime
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    16. MODS-Need.text
    Definition

    Free text field to be used if no code is available.

    ShortText
    Control0..1
    Typestring
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    18. MODS-Need.significant
    Definition

    Flag to identify a significant need

    ShortFlag to identify a significant need
    Control0..1
    Typeboolean
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    20. MODS-Need.urgent
    Definition

    Flag to identify a need that requires urgent support

    ShortFlag to identify a need that requires urgent support
    Control0..1
    Typeboolean
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension

    Guidance on how to interpret the contents of this table can be foundhere

    0. MODS-Need
    Definition

    MODS Definition: All health and care needs, including emotional, social, cultural, religious and spiritual needs, should be included in assessments about the care and treatment people receive.

    ShortMODS Need
    Logical ModelInstances of this logical model are not marked to be the target of a Reference
    2. MODS-Need.subjectOfCare
    Definition

    Person the information is about

    ShortPerson the information is about
    Control1..1
    TypeReference(MODS Subject of Care)
    4. MODS-Need.careWorker
    Definition

    Care actor who will perform the activity or performed the action or made the observation.

    ShortCare actor who will perform the activity or performed the action or made the observation.
    Control0..*
    TypeReference(MODS Care Worker)
    6. MODS-Need.coding
    Definition

    A reference to a code defined by a terminology system.

    ShortA reference to a code defined by a terminology system.
    Control0..*
    BindingThe codes SHOULD be taken from MODS Wish, Need, Preference Coding from SNOMED CT: Social Context, Procedures, and Clinical Findings
    (preferred to https://metadata.phase2.scip.synanetics.cloud/fhir/r4/ValueSet/MODS-SocialProcedureFindings-1)
    TypeCoding
    8. MODS-Need.category
    Definition

    Care and support needs identified as part of a care assessment.

    ShortCategory
    Control1..1
    BindingThe codes SHALL be taken from MODS Need Category
    (required to https://metadata.phase2.scip.synanetics.cloud/fhir/r4/ValueSet/MODS-NeedCategory-1)
    TypeCoding
    10. MODS-Need.date
    Definition

    The date, month, year and century, or any combination of these elements, of an EVENT. This could be the date an observation was made, the date of an assessment or the date an action has been performed.

    ShortDate/Time
    Control1..1
    TypedateTime
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    12. MODS-Need.text
    Definition

    Free text field to be used if no code is available.

    ShortText
    Control0..1
    Typestring
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    14. MODS-Need.significant
    Definition

    Flag to identify a significant need

    ShortFlag to identify a significant need
    Control0..1
    Typeboolean
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    16. MODS-Need.urgent
    Definition

    Flag to identify a need that requires urgent support

    ShortFlag to identify a need that requires urgent support
    Control0..1
    Typeboolean
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension

    Guidance on how to interpret the contents of this table can be foundhere

    0. MODS-Need
    Definition

    MODS Definition: All health and care needs, including emotional, social, cultural, religious and spiritual needs, should be included in assessments about the care and treatment people receive.

    ShortMODS Need
    Control0..*
    This element is affected by the following invariants: ele-1
    Is Modifierfalse
    Logical ModelInstances of this logical model are not marked to be the target of a Reference
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    2. MODS-Need.id
    Definition

    Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

    ShortUnique id for inter-element referencing
    Control0..1
    Typestring
    Is Modifierfalse
    XML FormatIn the XML format, this property is represented as an attribute.
    Summaryfalse
    4. MODS-Need.extension
    Definition

    May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

    ShortAdditional content defined by implementations
    Comments

    There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

    Control0..*
    TypeExtension
    Is Modifierfalse
    Summaryfalse
    Alternate Namesextensions, user content
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
    SlicingThis element introduces a set of slices on MODS-Need.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
    • value @ url
    • 6. MODS-Need.subjectOfCare
      Definition

      Person the information is about

      ShortPerson the information is about
      Control1..1
      TypeReference(MODS Subject of Care)
      8. MODS-Need.careWorker
      Definition

      Care actor who will perform the activity or performed the action or made the observation.

      ShortCare actor who will perform the activity or performed the action or made the observation.
      Control0..*
      TypeReference(MODS Care Worker)
      10. MODS-Need.coding
      Definition

      A reference to a code defined by a terminology system.

      ShortA reference to a code defined by a terminology system.
      Control0..*
      BindingThe codes SHOULD be taken from MODS Wish, Need, Preference Coding from SNOMED CT: Social Context, Procedures, and Clinical Findings
      (preferred to https://metadata.phase2.scip.synanetics.cloud/fhir/r4/ValueSet/MODS-SocialProcedureFindings-1)
      TypeCoding
      12. MODS-Need.category
      Definition

      Care and support needs identified as part of a care assessment.

      ShortCategory
      Control1..1
      BindingThe codes SHALL be taken from MODS Need Category
      (required to https://metadata.phase2.scip.synanetics.cloud/fhir/r4/ValueSet/MODS-NeedCategory-1)
      TypeCoding
      14. MODS-Need.date
      Definition

      The date, month, year and century, or any combination of these elements, of an EVENT. This could be the date an observation was made, the date of an assessment or the date an action has been performed.

      ShortDate/Time
      Control1..1
      TypedateTime
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      16. MODS-Need.text
      Definition

      Free text field to be used if no code is available.

      ShortText
      Control0..1
      Typestring
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      18. MODS-Need.significant
      Definition

      Flag to identify a significant need

      ShortFlag to identify a significant need
      Control0..1
      Typeboolean
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
      20. MODS-Need.urgent
      Definition

      Flag to identify a need that requires urgent support

      ShortFlag to identify a need that requires urgent support
      Control0..1
      Typeboolean
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension