Clinical Resources

Social History

Overview

The Social History section captures the lifestyle and social context of a patient, including occupation, education, living situation, and substance use.

Structuring this information supports risk assessment, care planning, and population-health analytics, where social factors often carry as much weight as clinical findings.

Clinical Data in Source Documents

Social history is usually documented in a dedicated Social History section, and sometimes woven into the History of Present Illness or a nursing assessment.

It commonly records occupation, marital status, and living arrangement, along with tobacco, alcohol, and other substance use, each with a status and, where noted, a frequency or quantity.

JSON Output

During processing, the platform extracts the available details into a structured JSON object.

The extracted fields include:

• Occupation, Education, Marital Status, Housing: The patient’s social and living context.
• Substance Use: A list of entries, each with a type, status, and frequency.
• Page Number: The source page, for traceability.

{
  "social_history": {
    "occupation": "Retired teacher",
    "education": "College",
    "marital_status": "Widowed",
    "housing": "Lives alone",
    "abuse": [
      {
        "type": "Tobacco",
        "status": "Former",
        "frequency": "1 pack per day for 20 years, quit 2005"
      }
    ],
    "page_number": 2
  }
}

FHIR Output

Social history is mapped to FHIR Observation resources categorized as social-history. Each distinct factor, such as tobacco use or living situation, becomes its own Observation so it can be coded and trended independently.

Key mappings include:

• Factor: Populated into Observation.code.text, for example “Tobacco use”.
• Category: Set to social-history to separate these from clinical findings.
• Value: The status and detail are captured in Observation.valueString.
• Patient Link: Observation.subject references the patient.

{
  "fullUrl": "urn:uuid:9c4e1b28-5a70-4d13-8f22-3b7d0e6a2c51",
  "resource": {
    "resourceType": "Observation",
    "status": "final",
    "category": [
      {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/observation-category",
            "code": "social-history"
          }
        ]
      }
    ],
    "code": {
      "text": "Tobacco use"
    },
    "subject": {
      "reference": "Patient/b17aaab1-311c-4d98-9c93-030277d0aeb0"
    },
    "valueString": "Former, 1 pack per day for 20 years, quit 2005"
  }
}