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: MODSSocialCircumstance - Detailed Descriptions

Draft as of 2026-06-10

Definitions for the MODS-SocialCircumstance logical model.

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

0. MODS-SocialCircumstance
Definition

MODS Definition: Details of the persons social circumstances


Base definition for all elements in a resource.

ShortMODS Social CircumstanceBase 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-SocialCircumstance.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-SocialCircumstance.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-SocialCircumstance.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ url
  • 6. MODS-SocialCircumstance.subjectOfCare
    Definition

    Person the information is about

    ShortPerson the information is about
    Control1..1
    TypeReference(MODS Subject of Care)
    8. MODS-SocialCircumstance.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-SocialCircumstance.datetime
    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-SocialCircumstance.text
    Definition

    The current and/or previous relevant social circumstances of the person.

    ShortText
    Control1..1
    Typestring
    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-SocialCircumstance
    Definition

    MODS Definition: Details of the persons social circumstances

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

    Person the information is about

    ShortPerson the information is about
    Control1..1
    TypeReference(MODS Subject of Care)
    4. MODS-SocialCircumstance.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-SocialCircumstance.datetime
    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
    8. MODS-SocialCircumstance.text
    Definition

    The current and/or previous relevant social circumstances of the person.

    ShortText
    Control1..1
    Typestring
    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-SocialCircumstance
    Definition

    MODS Definition: Details of the persons social circumstances

    ShortMODS Social Circumstance
    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-SocialCircumstance.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-SocialCircumstance.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-SocialCircumstance.extension. The slices areUnordered and Open, and can be differentiated using the following discriminators:
    • value @ url
    • 6. MODS-SocialCircumstance.subjectOfCare
      Definition

      Person the information is about

      ShortPerson the information is about
      Control1..1
      TypeReference(MODS Subject of Care)
      8. MODS-SocialCircumstance.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-SocialCircumstance.datetime
      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-SocialCircumstance.text
      Definition

      The current and/or previous relevant social circumstances of the person.

      ShortText
      Control1..1
      Typestring
      Primitive ValueThis primitive element may be present, or absent, or replaced by an extension